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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards" , which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://ipr.etsi.org ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI Technical Committee Smart Card Platform (SCP). 

The contents of the present document are subject to continuing work within TC SCP and may change following formal 
TC SCP approval. If TC SCP modifies the contents of the present document, it will then be republished by ETSI with 
an identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

early working draft; 

1 presented to TC SCP for information; 

2 presented to TC SCP for approval; 

3 or greater indicates TC SCP approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document covers the minimum characteristics considered necessary in order to provide compliance to 
TS 102 705 [1]. 

It specifies conformance test cases for the UICC Apphcation Programming Interface for Java Card^*^ for contactless 
Applications. 



2 References 

References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the 
reference document (including any amendments) applies. 

• In the case of a reference to a TC SCP document, a non specific reference implicitly refers to the latest version 
of that document in the same Release as the present document. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee 
their long term validity. 

2.1 Normative references 

The following referenced documents are necessary for the application of the present document. 

[I] ETSI TS 102 705: "Smart Cards; UICC Application Programming Interface for Java Card™ for 
Contactless Applications". 

[2] ISO/lEC 7816-3: "Identification cards - Integrated circuit cards - Part 3: Cards with contacts - 

Electrical interface and transmission protocols". 

[3] ETSI TS 102 622: "Smart Cards; UICC - Contactless Front-end (CLF) Interface; Host Controller 

Interface (HCI)". 

[4] ETSI TS 101 220: "Smart Cards; ETSI numbering system for telecommunication application 

providers". 

[5] ETSI TS 102 221: "Smart Cards; UICC-Terminal interface; Physical and logical characteristics". 

[6] ETSI TS 102 241 : "Smart Cards; UICC Application Programming Interface (UICC API) for Java 

Card(TM)". 

[7] ETSI TS 102 223: "Smart Cards; Card Application Toolkit (CAT)". 

[8] ISO/lEC 9646-7: "Information technology - Open Systems Interconnection - Conformance testing 

methodology and framework - Part 7: Implementation Conformance Statements". 

[9] ETSI TS 102 226: "Smart Cards; Remote APDU structure for UICC based applications". 

[10] GlobalPlatform: "GlobalPlatform Card Specification Version 2.2, Amendment C: Contactless 

Services" Version 1.0. 

NOTE: See http://www. globalplatform.org/ . 

[II] Sun Microsystems "Application Programming Interface, Java Card^^ Platform, 3.0.1 Classic 
Edition" . 
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[12] Sun Microsystems "Runtime Environment Specification, Java Card^w Platform, 3.0.1 Classic 

Edition". 

[13] Sun Microsystems "Virtual Machine Specification Java Card^^ Platform, 3.0.1 Classic Edition". 

NOTE: SUN Java Card Specifications can be downloaded at 

http://www.oracle.com/technetwork/iava/iavame/iavacard/download/overview/index.html . 

[14] ETSI TS 102 613: "Smart Cards; UlCC - Contacdess Front-end (CLE) Interface; Part 1: Physical 

and data link layer characteristics". 

[15] Java Card API and Export File for Card Specification v2.2.1 (org.globalplatform) vl.5. 

[16] Java Card Contactless API and Export File for Card Specification v2.2.1 

(org.globalplatform.contactless) vl . 1 . 

2.2 Informative references 

The following referenced documents are not necessary for the application of the present document but they assist the 
user with regard to a particular subject area. 

Not applicable. 



3 Definitions, symbols and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

applet installation parameters: values for applet installation parameters in the Install(Install) command 

Conformance Requirement Reference (CRR): description of the expected HCI API behaviour according to 
TS 102 705 [1] 

contactless mode: is used as a generic term for "Card Emulation Mode" and "Reader Mode" 

HCP message: message as specified in TS 102 622 [3] 

NOTE: An HCP message can be of type "command", "event" or "response to a command". 

test case: elementary test that checks for compliance with one or more Conformance Requirement References 

test procedure: sequence of actions/commands to perform all the test cases defined in a test area 

test source file: file containing methods that will load and install test applet in the card, execute and verify the test 
results, and restore the Default Initial Conditions on the UICC (when possible) 

RF Technology: radio frequency technology supported by the HCI (TS 102 622 [3]) protocol specification 

3.2 Symbols 

For the purposes of the present document, the symbols given in TS 102 705 [1] apply. 
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3.3 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 



AID 
APDU 



API 
CAT 
CB 
CLF 



INS 

ISO 

JCRE 

RF 

SAA 

SDK 

sw 

SWF 
TAR 
TBD 



Application IDentifier 
Application Protocol Data Unit 



NOTE: According to ISO/IEC 7816-3 [2]. 



Application Programming Interface 
Card Application Toolkit 
Chaining Bit 
Contactless Front-end 



NOTE: According to TS 102 622 [3]. 

CRR Conformance Requirements Reference 

CRRC Conformance Requirement Reference Context Error 

CRRN Conformance Requirement Reference Normal 

CRRP Conformance Requirement Reference Parameter Error 

CRS Contactless Registry Services 

DUT Device Under Test 

EVT EVenT 

FES For Further Study 

GND GrouND 

HCI Host Controller Interface 

NOTE: According to TS 102 622 [3]. 

HCP Host Controller Protocol 

NOTE: According to TS 102 622 [3]. 



INStruction 

International Organisation for Standardisation 

Java Card'^ Run-time Environment 

Radio Frequency 

Service Availability and Access possibility for the different services 

Software Development Kit 

Status Word 

Single Wire Protocol 

Toolkit Application Reference 

To Be Defined 



3.4 



Formats 



3.4.1 Format of the table of optional features 

The columns in table 4. 1 have the following meaning. 



Column 


Meaning 


Option 


The optional feature supported or not by the DUT. 


Status 


See clause 3.4.3. 


Support 


The support columns are to be filled in by the supplier of the implementation. The following common 
notations, defined in ISO/IEC 9646-7 [8], are used for the support column in table 4.1 . 
Y or y supported by the implementation. 
N or n not supported by the implementation. 

N/A, n/a or - no answer required (allowed only if the status is N/A, directly or after evaluation of a 
conditional status). 


Mnemonic 


The mnemonic column contains mnemonic identifiers for each item. 
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3.4.2 Format of the applicability table 

The applicability of every test in table 4.2 is formally expressed by the use of Boolean expression defined in the 
following clause. 

The columns in table 4.2 have the following meaning. 



Column 


Meaning 


Clause 


The "Clause" column identifies the clause containing the test case referenced in the "Test case 
number and description" column. 


Test case number 
and description 


The "Test case number and description" column gives a reference to the test case number (along 
with the corresponding description) detailed in the present document and required to validate the 
DUT 


Release 


The "Release" column gives the Release applicable and onwards, for the corresponding test case. 


Execution 
requirements 


The usage of the "Execution requirements" column is described in clause 4.4. 


Rel-x UICC 


For a given Release, the corresponding "Rel-x UICC" column lists the tests required for a DUT to be 
declared compliant to this Release. 


Support 


The "Support" column is blank in the proforma, and is to be completed by the manufacturer in 
respect of each particular requirement to indicate the choices, which have been made in the 
implementation. 



3.4.3 Status and Notations 

The "Rel-x" columns show the status of the entries as follows: 

The following notations, defined in ISO/IEC 9646-7 [8], are used for the status column: 

M mandatory - the capability is required to be supported. 

O optional - the capability may be supported or not. 

N/A not applicable - in the given context, it is impossible to use the capability. 

X prohibited (excluded) - there is a requirement not to use this capability in the given context. 

O.i qualified optional - for mutually exclusive or selectable options from a set. "i" is an integer which 

identifies an unique group of related optional items and the logic of their selection which is 
defined immediately following the table. 

Ci conditional - the requirement on the capability ("M", "O", "X" or "N/A") depends on the support 

of other optional or conditional items, "i" is an integer identifying an unique conditional status 
expression which is defined immediately following the table. For nested conditional expressions, 
the syntax "IF ... THEN (IF ... THEN ... ELSE...) ELSE ..." is to be used to avoid ambiguities. 

References to items 

For each possible item answer (answer in the support column) there exists a unique reference, used, for example, in the 
conditional expressions. It is defined as the table identifier, followed by a solidus character "/", followed by the item 
number in the table. If there is more than one support column in a table, the columns are to be discriminated by letters 
(a, b, etc.), respectively. 

EXAMPLE: 4. 1/4 is the reference to the answer of item 4 in table 4. 1 . 

The ID (identifier) of a test case consists of a main identifier and optionally a sub-identifier; for example, 2-1 and 3. A 
sub-identifier is used when there are multiple test cases with this same main identifier; otherwise, no sub -identifier is 
used. Reference to a main identifier when the relevant test cases also have sub-identifier are assumed to reference all of 
the test cases with that main identifier. 



£75/ 



Release 9 



12 



ETSI TS 103 115 V9.1.0 (2013-07) 



4 Applicability 

4.1 Table of optional features 

The device supplier shall state the support of possible options in table 4.1. See clause 3.4 for the format of table 4.1. 

Table 4.1 : Options 



Item 


Option 


Status 


Support 


Mnemonic 


1 


Card emulation, Type A 







CE TYPE A 


2 


Card emulation, Type B 







CE TYPE B 


3 


Card emulation. Type B' 







CE TYPE B PRIME 


4 


Card emulation. Type F 







CE TYPE F 


5 


Reader Mode, Type A 







RM TYPE A 


6 


Reader Mode, Type B 







RM TYPE B 


7 


HCP message size greater than supported buffer size 







MSG GT BUF 



4.2 Applicability table 



Table 4.2 specifies the applicability of each test case to the device under test. See clause 3.4 for the format of table 4.2. 

Clause 4.4 should be referenced for usage of the execution requirements which are referenced in table 4.2 a) and 
described in table 4.2 c). 

Table 4.2 a): Applicability of tests 



Clause 


Test case number and description 


Release 


Execution 
requirements 


Rel-9 
UICC 


Support 


6.1.1.1 


Method getHCIService (ID2, ID4) 


Rel-9 


SAA1 


M 




6.1.1.1 


Method getHCIService (ID1-1) 


Rel-9 


SAA1 


M 




6.1.1.1 


Method getHCIService (ID1-2) 


Rel-9 


SAA2, 
SAA1 


M 




6.1.1.1 


Method getHCIService (ID1-3) 


Rel-9 


SAA3 


M 




6.1.1.1 


Method getHCIService (ID3-1) 


Rel-9 


SAA6 


M 




6.1.1.1 


Method getHCIService (ID3-2) 


Rel-9 


SAA1, 
SAA7 


M 




6.1.1.1 


Method getHCIService (ID3-3) 


Rel-9 


SAA8 


M 




6.1.1.1 


Method getHCIService (ID5-1) 


Rel-9 


SAA4 


M 




6.1.1.1 


Method getHCIService (ID5-2) 


Rel-9 


SAA5 


M 




6.1.1.2 


Method getPowerMode 


Rel-9 


SAA1 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID1-1, ID3-1) 


Rel-9 


SAA1 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID1-2) 


Rel-9 


SAA2, 
SAA1 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID1-3) 


Rel-9 


SAA3 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID2) 


Rel-9 




M 




6.1.1.3 


Method IsHCIServiceAvailable (ID3-2) 


Rel-9 


SAA3 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID4-1) 


Rel-9 


SAA4 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID4-2) 


Rel-9 


SAA5 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID5-1) 


Rel-9 


SAA10 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID5-2) 


Rel-9 


SAA11 


M 




6.1.2.1 


Method register (ID1-1, ID2, ID3, ID4) 


Rel-9 


SAA1 


M 




6.1.2.1 


Method register (ID1 , ID2, ID3-1 , ID4) 


Rel-9 


SAA1 


M 




6.1.2.1 


Method register (ID1-2, ID3-2) 


Rel-9 


SAA1, 
SAA2 


M 




6.1.2.1 


Method register (ID1 -3, ID3-3) 


Rel-9 


SAA3 


M 




6.1.2.2 


Method deregister(ID1-1, ID1-3) 


Rel-9 


SAA1 


M 




6.1.2.2 


Method deregister (ID1-2, ID2) 


Rel-9 


SAA1, 
SAA2 


M 




6.1.2.3 


Method activateEvent (ID1, ID4, ID6, ID7, IDS, ID9, 
ID10) 


Rel-9 


SAA1 


M 




6.1.2.3 


Method activateEvent (ID2) 


Rel-9 


SAA3 


M 





£75/ 



Release 9 



13 



ETSI TS 103 115 V9.1.0 (2013-07) 



Clause 


Test case number and description 


Release 


Execution 
requirements 


Rel-9 
UICC 


Support 


6.1.2.3 


Method activateEvent (ID3) 


Rel-9 


SAA1, 
SAA2 


M 




6.1.2.3 


Method activateEvent (ID5-1) 


Rel-9 


SAA10 


SAA10, 
SAA3 




6.1.2.3 


Method activateEvent (ID5-2) 


Rel-9 


SAA11 


SAA1 1 , 
SAA3 




6.1.2.4 


Method deactivateEvent (ID1, ID4, ID5) 


Rel-9 


SAA1 


M 




6.1.2.4 


Method deactivateEvent (ID2, ID7) 


Rel-9 


SAA3 


M 




6.1.2.4 


Method deactivateEvent (ID3, ID6) 


Rel-9 


SAA1, 
SAA2 


M 




6.1.2.5 


Method requestCallbacl<Notification 


Rel-9 


SAA1 


M 




6.1.2.6 


Method getEventNotificationStatus(ID1, ID2, ID5-1) 


Rel-9 


SAA1 


M 




6.1.2.6 


Method getEventNotificationStatus{ID3,ID4, ID5-2) 


Rel-9 


SAA3 


M 




6.1.2.6 


Method getEventNotificationStatus(ID5-3, ID6, ID7) 


Rel-9 


SAA2, 
SAA1 


M 




6.1.3.1 


Method isHeading 


Rel-9 


SAA1 


M 




6.1.3.2 


Method isComplete 


Rel-9 


SAA1 


M 




6.1.3.3 


Method getType(IDI) 


Rel-9 


SAA1 


M 




6.1.3.3 


Method getType (1D2) 


Rel-9 


SAA2, 
SAA1 


M 




6.1.3.4 


Method getlnstruction 


Rel-9 


SAA1 


M 




6.1.3.6 


Method getReceiveLength 


Rel-9 


SAA1 


M 




6.1.3.7 


Method getReceiveBuffer 


Rel-9 


SAA1 


M 




6.1.4.1 


Method throwit 


Rel-9 


SAA1 


M 




6.1.5.1 


Method onCallback (ID1, ID2, ID3) 


Rel-9 


SAA1 


M 




6.1.5.1 


Method onCallbacl< (ID4) 


Rel-9 


SAA1 


C002 




6.1.5.1 


Method onCallbacl< (ID5) 


Rel-9 


SAA1 


C001 




6.2.1.1.1 


Method prepareAndSendGetParameterCommand 
(ID1) 


Rel-9 


SAA1 


C001 




6.2.1.1.1 


Method prepareAndSendGetParameterCommand 
(ID2) 


Rel-9 


SAA1 


C002 




6.2.1.1.1 


Method prepareAndSendGetParameterCommand 
(ID3-1) 


Rel-9 


SAA1 


C001 
C007 




6.2.1.1.1 


Method prepareAndSendGetParameterCommand 
(ID3-2) 


Rel-9 


SAA1 


C002 
C007 




6.2.1.1.2 


Method prepareAndSendSendDataEvent (ID1) 


Rel-9 


SAA1 


C001 




6.2.1.1.2 


Method prepareAndSendSendDataEvent (102) 


Rel-9 


SAA1 


C002 




6.2.1.1.2 


Method prepareAndSendSendDataEvent {ID4, ID5) 


Rel-9 


SAA1 


M 




6.2.1.1.2 


Method prepareAndSendSendDataEvent (103) 


Rel-9 


SAA1 


C007 




6.2.1.1.3 


Method selectingMessage 


Rel-9 


SAA1 


M 




6.2.1.2.1 


Method getCardRFType (ID1) 


Rel-9 


SAA1 


C001 




6.2.1.2.1 


Method getCardRFType (ID2) 


Rel-9 


SAA1 


C002 




6.2.1.2.1 


Method getCardRFType (ID4) 


Rel-9 


SAA1 


C003 




6.2.1.2.1 


Method getCardRFType (ID3) 


Rel-9 


SAA1 


C004 




6.2.1.3.1 


Method onCallbacl< (ID1,ID2, ID3, ID5-2) 


Rel-9 


SAA1 


C001 




6.2.1.3.1 


Method onCallbacl< (ID4, ID5, ID6, ID5-3) 


Rel-9 


SAA1 


C002 




6.2.1.3.1 


Method onCallbacl< (ID5-1, ID5-4) 


Rel-9 


SAA1 


M 




6.2.2.1.1 


Method prepareAndSendConnectivityEvent (ID1, 
ID3, ID4, ID5) 


Rel-9 


SAA2, 
SAA1 


M 




6.2.2.1.1 


Method prepareAndSendConnectivityEvent (ID2-1) 


Rel-9 


SAA2, 
SAA1, 
SAA10 


M 




6.2.2.1.1 


Method prepareAndSendConnectivityEvent (ID2-1) 


Rel-9 


SAA2, 
SAA1, 
SAA11 


M 




6.2.2.1.1 


Method prepareAndSendConnectivityEvent (ID6) 


Rel-9 


SAA2, 
SAA1, 
SAA9 


M 




6.2.2.1.2 


Method prepareAndSendTransactionEvent 
byte[] aid, short aidOffset, short aidLen, 
byte[] parameters, short parametersOffset, 
short parametersLen) {ID1, IDS, ID4, ID5) 


Rel-9 


SAA1, 
SAA2 


M 
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Clause 


Test case number and description 


Release 


Execution 
requirements 


Rel-9 
UICC 


Support 


6.2.2.1.2 


Method prepareAndSendTransactionEvent 
byte[] aid, short aidOffset, short aidLen, 
byte[] parameters, short parametersOffset, 
short parametersLen) (ID2-1) 


Rel-9 


SAA2, 
SAA10 


M 




6.2.2.1.2 


Method prepareAndSendTransactionEvent 
byte[] aid, short aidOffset, short aidLen, 
byte[] parameters, short parametersOffset, 
short parametersLen) (ID2-2) 


Rel-9 


SAA2, 
SAA11 


M 




6.2.2.1.3 


Method prepareAndSendTransactionEvent 
(byte[] parameters, short parametersOffset, 
short parametersLen ) (ID1, ID3, ID4) 


Rel-9 


SAA2 


M 




6.2.2.1.3 


Method prepareAndSendTransactionEvent 
(byte[] parameters, short parametersOffset, 
short parametersLen ) (ID2-1) 


Rel-9 


SAA2, 
SAA10 


M 




6.2.2.1.3 


Method prepareAndSendTransactionEvent 
(byte[] parameters, short parametersOffset, 
short parametersLen ) (ID2-2) 


Rel-9 


SAA2, 
SAA11 


M 




6.2.3.1.1 


Method restartReaderModeProcedure (ID1) 


Rel-9 


SAA3 


COOS 




6.2.3.1.1 


Method restartReaderModeProcedure (ID2) 


Rel-9 


SAA3 


C006 




6.2.3.1.1 


Method restartReaderModeProcedure (ID3, ID4) 


Rel-9 


SAA3 


M 




6.2.3.1.1 


Method restartReaderModeProcedure (ID5-1) 


Rel-9 


SAA3, 
SAA10 


M 




6.2.3.1.1 


Method restartReaderModeProcedure (ID5-2) 


Rel-9 


SAA3, 
SAA11 


M 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID1) 


Rel-9 


SAA3 


COOS 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID2) 


Rel-9 


SAA3 


C006 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID4, IDS, ID6, ID7) 


Rel-9 


SAA3 


M 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID3-1) 


Rel-9 


SAA3, 
SAA10 


M 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID3-2) 


Rel-9 


SAA3, 
SAA11 


M 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(ID1) 


Rel-9 


SAA3 


COOS 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(ID2) 


Rel-9 


SAA3 


C006 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(ID3-1) 


Rel-9 


SAA3, 
SAA10 


M 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(1D3-2) 


Rel-9 


SAA3, 
SAA11 


M 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(ID4) 


Rel-9 


SAA3 


C007 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(IDS) 


Rel-9 


SAA3 


M 




6.2.3.2.1 


Method onCallbacl< 


Rel-9 


SAA3 


M 




6.2.3.2.1 


Method onCallbacl< (ID1, ID2, ID3, ID4) 


Rel-9 


SAA3 


COOS 




6.2.3.2.1 


Method onCallbacl< (IDS, ID6, ID7, IDS) 


Rel-9 


SAA3 


C006 





Table 4.2 b): Conditional items referenced by table 4.2 a) 



Conditional item 


Description 


C001 


IF CE TYPE A THEN M ELSE N/A 


C002 


IF CE TYPE B THEN M ELSE N/A 


COOS 


IF CE TYPE B PRIME THEN M ELSE N/A 


C004 


IF CE TYPE F THEN M ELSE N/A 


COOS 


IF RM TYPE A THEN M ELSE N/A 


C006 


IF RM TYPE B THEN M ELSE N/A 


C007 


IFO MSG GT BUF THEN M ELSE N/A 
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Table 4.2 c): Execution requirements referenced by table 4.2 a) 



Execution 
requirement 


Description 


SAA1 


Card emulation service is available 


SAA2 


Connectivity service is available 


SAA3 


Reader IVIode service is available 


SAA4 


Access not allowed for Applet for Card Emulation service 


SAA5 


Access not allowed for Applet for Reader service 


SAA6 


Card emulation service is not available 


SAA7 


Connectivity service is not available 


SAA8 


Reader Mode service not available 


SAA9 


Proactive functionality in TS 102 241 [6] is supported 


SAA10 


Toolkit application is available and registered to the ENVELOPE (EVENT DOWNLOAD - Contactless 
state request) and allowed to switch on/off HCI interface 


SAA11 


No CRS on the card and test applet acting like CRS can be loaded 



4.3 Information provided by the device supplier 

The device supplier shall provide the information indicated in table 4.3. 

Table 4.3: Information provided by device suppliers 



Item 


Description 


Value 


Mnemonic 


1 


Presence of an application associated to an contactless applet that can be launched in the 
terminal host using EVT TRANSACTION 




AID, 
Parameters 


2 


Supported received message buffer size 







4.4 Execution requirements 



Table 4.2, Applicability of tests, specifies execution requirement (SAAn) for several test cases, to define the service 
availability and access possibility for the different services. For these test cases, the availability of the different services 
shall be guaranteed in order to execute the corresponding test procedure against the DUT. In case of absence of a 
particular (SAAn), the corresponding test case should not be carried out. 
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5 Test environment 

This clause specifies requirements that shall be met and the testing rules that shall be followed during the test 
procedure. 

5.1 Test environment description 

The general architecture for the test environment is: 



Scope of the Test Suite. 



Elements of the Test Suite 



Test preparation 



Test HCI API 
applet 



^N, 



Applet ".cap" 



Applet 
Instalation 
parameter 



^M 



Test Procedure 
exchange 



HCI cmd/event 



HCIcmd/ ■* 
response 



Test preparation 
tools 



Converter 



Loader 



Terminal 
simulation 



HCI (TS 102 622) 



SWP(TS 102 613) 



Implementation Under Test (HIT) 



Apps relatec 
to the 
other 
interfaces 



CRS App 
CRELApp 



Card 

Emulation 
Mode 
Applets 



1 

Reader 

Mode 

Applets 




Test 
Applets 



Java CarJ" 
package 



uicc.hci. framework 
package 



uicc.hci. service 
packages 



Java Card" Runtime Environment 



CL Registry 



Contactless 
Framework 



HCI (TS 102 622) 



SWP (TS 102 613) 



Figure 5.1 

5.2 Tests format 
5.2.1 Test area reference 

Each test area is referenced as follows: 

For HCI Framework and HCI services Testing: 'Api_[package name]_[class name]_[method name]' where 

• package name: 

uicc.hci. framework: '1'. 
uicc.hci. services: '2'. 

• class name: 

yyy: 3 letters for each class/interface. 

■ See annex A for full classes/interfaces acronyms list. 
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• method name: 

zzz [input parameters] : 

■ See annex A for full methods name acronyms list. 

5.2.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

• Method prototype as listed in TS 102 705 [1]. 

• Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN). 

• Parameters error: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP). 

• Context error: 

Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC). 

5.2.1.2 Test suite files 

Each test suite files contains a table to indicate the correspondence between the applet names and the different test 
cases. 



Applet Name 


Test case ID 


[Test Area Reference] [Test applet number].java 


Test case 



The test applets and the related Cap Files use the following naming convention: 

• Test Applet: [Test Area Reference]_[Test applet number] .Java 

• Cap File: [Test Area Reference]. cap 
The applet numbers start from '1'. 

The Cap File format is described in Java Card'"^ Virtual Machine Specification [13]. 
All files from the same test area are located in the same subfolder. 

5.2.1.3 Initial conditions 

In addition to the general precondtions defined in clause 5.3, this clause defines the initial conditions prior to the 
execution of each test case; i.e. for each ID. 

5.2.1 .4 Test procedure 

Each test procedure contains a table to indicate the expected responses form the API and APDU as follows. 



Test Case 


Id 


HCI commands 


API Description 


API Expectation 


HCI Response 


CRR 




Commands sent on 
HCI interface 


Test Case detailed 
description 


API expected 
behaviour 


Expected behaviour at 
APDU/HCI level 


Conformance 
Requirements Reference 
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The ID of a test case consists of the identifier in the ID column and (if present) the sub-identifier in the HCI commands 
column. Examples of valid IDs are 2-1 and 3. 



5.3 



Initial conditions 



Unless otherwise specified, test cases shall be executed in full power mode only. 

The Initial Conditions are a set of general prerequisites for the UICC prior to the execution of testing. For each test 
procedure described in the present document, the following rules apply to the Initial Conditions: 

• unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages 
specific to other test procedures shall not be present. 

Prior to any test: 

• For test cases run in full power mode, the test environment shall have the UICC powered on and performed the 
session initialization and RF registries updates as described in TS 102 622 [3]. 

• For test cases run in low power mode, the test environment shall power on the UICC, activate the SWP 
interface, perform the session initialization and RF registries updates as described in TS 102 622 [3], power 
down the UICC and power it up again in low power mode. 

• The test can be executed once the HCI interface is idle; i.e. no further communication is expected. 



5.4 Package name 



Java packages integrating this Test Suite shall follow this naming convention: 

uicc.hci.test.framework.[Test Area Reference]: Java Card packages containing Test Area References for the 
TS 102 705 [1] uicc.hci. framework package. 

uicc.hci.test.services.cardemulation.[Test Area Reference]: Java Card packages containing Test Area References for 
the TS 102 705 [1] uicc. hci. services. cardemulation package. 

uicc.hci.test.services.connectivity.[Test Area Reference]: Java Card packages containing Test Area References for 
the TS 102 705 [1] uicc. hci. services. connectivity package. 

uicc.hci.test.services.readerniode.[Test Area Reference]: Java Card packages containing Test Area References for 
the TS 102 705 [1] uicc. hci. services.readermode package. 

where the Test Area Reference is written in lower case. 

EXAMPLE: The package ../uicc. hci.test.framework.[Test Area Reference] creates the following directory 
structure ../uicc/hci/test/framework/[TestArea Reference]/Api_l _..._[ l..n].'*, where 
Api_l_..._[l..n].*' are the different test applets Java source files used in [Test Area Reference] . 



5.5 AID coding 



The AID coding for the Test Packages, Applet classes and Applets shall be as specified in TS 101 220 [4]. In addition, 
the following TAR and Application Provider specific data values are defined for use within the present document: 

AID coding 

Byte1 [ I Byte 12 | Byte 13 | Byte 14 | Byte 15 | Byte 16 | 



Application Provider specific data 



TAR 



Specified in TS 101 220 [4] 
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TAR coding (3 bytes / 24 bits): 



1 b1 1 


1 b4 1 b5 1 


1 b8 1 b9 1 


b16| 1 1 |b17| 


|b24| 
























' 


Applet class/instance number 








Package number 










Core package identifier 












Test Part Identifier 



Applet instance number, Applet Class number, Package number: 

• For package AID, package number shall start from and class and instance numbers shall be 0. 

• For class AID, package number is the number of the class package, class number shall start from 1 and 
instance shall be 0. 

• For instance AID, package and class number are the number of class and package of which instance belongs, 
and instance number shall start from 1. 

Test Part and Core Package Identifier 

• 0000 0000 reserved (as TAR= '00.00.00' is reserved for Issuer Security Domain). 

• 0010 0001 uicc.hci. test. framework. 

• 0010 0100 uicc.hci. test. servces. 

• 0010 0101 uicc.hci. test. services.cardemulation. 

• 0010 0100 uicc.hci. test. servces. connectivity. 

• 0010 0100 uicc.hci. test. servces.readermode. 
Application Provider specific data (1 byte): 

• '00' for Package. 

• 'Or for Applet class. 

• '02' for Applet Instance. 
EXAMPLE: Annex B. 



5.6 Test equipment 



These clauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 

5.6.1 Test tool 

This test tool shall meet the following requirements: 

be able to send and receive commands using the underlying HCI resources (e.g. gates and pipes) defined by 
the HCI protocol as specified in TS 102 622 [3]; 

be able to send and receive the commands correctly on the lower layer; i.e TS 102 613 [14]; 

the result of I/O commands shall be presented at the application layer; 

be able to provide results of the tests; 

shall send and/or compare all data specified in test file. 
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5.6.2 Java Software Development Kit 



Java Card^*^ software development kit (SDK) version supported by Java Card 3.0.1 specifications ([11], [12], [13]) is 
1.5. 



6 Test cases 

6.1 Package uicc.hci.framework 

6.1.1 Class HCIDevice 
6.1.1.1 Method getHCIService 

Test Area Reference: Api_l_Hdv_Gsr. 

6.1 .1 .1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

public static HCIService getHCIService {short servicelD) 

throws HCIException, 

j avacard . framework . SystemException 



6.1.1.1.1.1 



Normal execution 



CRRNl: used to retrieve instances that implement one of HCIService subinterfaces defined in the present 
document. 

CRRN2: returns reference to the permanent JCRE entry point object of the HCIService. 

CRRN3: returns null if not yet registered. 



6.1.1.1.1.2 



Parameter errors 



• CRRPl : javacard.framework.SystemException is thrown with the reason code ILLEGAL_VALUE if the 
servicelD does not match with the predefined values. 



6.1.1.1.1.3 



Context errors 



CRRCl: HCIException thrown with reason HCI_ACCESS_NOT_GR ANTED if access to the indicated 
service is not permitted for the Applet. 

CRRC2: HCIException is thrown with reason HCI_SERVICE_NOT_AVAILABLE if the requested service 
type is not available. 



6.1.1.1.2 



Test suite files 



Applet Name 


Test case ID 


Api 1 Hdv Gsr l.java 


1 


Api 1 Hdv Gsr 2.java 


2 


Api 1 Hdv Gsr l.java 


3 


Api 1 Hdv Gsr l.java 


4 


Api_1_Hdv_Gsr_1 .Java 


5 
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6.1.1.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 



6.1.1.1.4 



Test procedure 



Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 


1 


Select supported and registered service 


1 - 


getHCIService {) 


No exception shall be thrown 


EVT SEND DATA 


N1, 




EVT SEND DATA 


servicelD = 




(SW - '90 00') 


N2 




(INS = '01') 


CARD_EMULATION_SERVICE_ID 








2- 


getHCIService {) 


No exception shall be thrown 


EVT SEND DATA 


N1, 




EVT SEND DATA 


servicelD = 




(SW - '90 00') 


N2 




(INS = '02') 


CONNECTIVITY_SERVICE_ID 








3 - Send command 


getHCIService {) 


No exception shall be thrown 


SW - '90 00' 


N1, 




on ISO interface; 


servicelD = 






N2 




the initial 


READER_SERVICE_ID 










conditions in 












clause 6.1.1.1.3 












not applicable here 












- select applet- 












INS= '03' 










2 


Applet not registered 


EVT SEND DATA 


Applet . register { ) has not 


Return: Null 


EVT SEND DATA 


N3 




(INS = '01') 


yet been invoked . 

getHCIService {) 

servicelD = 

CARD EMULATION SERVICE ID 




(SW - '90 00') 




3 


Select not availabile service 


1 - Send command 


getHCIService {) 


Shall throw 


SW-'90 01' 


C2 




on ISO interface; 


servicelD = 


uicc.hci.framework.HCIExcept 








the initial 


CardEmulationService 


ion with error code 








conditions in 




HCI SERVICE NOT AVAILA 








clause 6.1.1.1.3 




BLE 








not applicable here 












- select applet- 












(INS = '01') 










2- 


getHCIService {) 


Shall throw 


EVT SEND DATA 


C2 




EVT SEND DATA 


servicelD = 


uicc.hci.framework.HCIExcept 


(SW-'90 01') 






(INS='02') 


Connect ivityService 


Ion with error code 

HCI SERVICE NOT AVAILA 

BLE 






3 - Send command 


getHCIService {) 


Shall throw 


SW - '90 01 ' 


C2 




on ISO interface; 


servicelD = ReaderService 


uicc.hci.framework.HCIExcept 








the initial 




ion with error code 








conditions in 




HCI SERVICE NOT AVAILA 








clause 6.1.1.1.3 




BLE 








not applicable here 












- select applet- 












(INS = '03') 










4 


Select undefined service 


EVT SEND DATA 


getHCIService { ) 


Shall throw 


EVT SEND DATA 


PI 




(INS = '04') 


servicelD = -1 


javacard.framework.SystemE 
xception with error code 
ILLEGAL VALUE 


(SW - '90 00') 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 


5 


Access not granted 


1 - Send command 


getHCIService {) 




Shall throw 


SW - '90 02' 


CI 




on ISO interface; 
the initial 


sevicelD = 
CardEmulationService 




uicc.hci.framework.HCIExcept 
ion with error code 








conditions in 






HCI ACCESS NOT GRANT 








clause 6.1.1.1.3 






ED 








not applicable here 
- select applet- INS 
= '01' 












2 - Send command 


getHCIService {) 




Shall throw 


SW - '90 02' 


CI 




on ISO interface; 
the initial 


servicelD = 
ReaderSevice 




uicc.hci.framework.HCIExcept 
Ion with error code 








conditions in 






HCI ACCESS NOT GRANT 








clause 6.1.1.1.3 






ED 








not applicable here 
- select applet- 
INS='03' 













6.1.1.2 Method getPowerMode 

Test Area Reference: Api_l_Hdv_Gpm. 

6.1 .1 .2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

public static byte getPowerMode { ) 

6.1.1.2.1.1 Normal execution 

• CRRNl: returns the current power mode of the UICC as defined in TS 102 613 [14]. 

• CRRN2: returns the current power mode or -1 if the power mode cannot be retrieved. 

• CRRN3: Applets communicating through the process() method shall also be able to use the API services 
defined in TS 102 705 [1] which do not require a CardEmulationListener registration (e.g. requesting the 
power mode or connectivity service). 



6.1.1.2.1.2 


Parameter errc 


• None. 




6.1.1.2.1.3 


Context errors 


• None. 




6.1.1.2.2 


Test suite files 



Applet Name 


Test case ID 


Api 1 Hdv Gpm Ljava 


1 


Api 1 Hdv Gpm Ljava 


2 


Api_1_Hdv_Gpm_1 .Java 


3 



6.1 .1 .2.3 Initial conditions 

• The UICC is not powered up. 
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6.1.1.2.4 



Test procedure 



Test case 


ID 


HCI Command API Description API Expectation HCI Response CRR 


1 


Verify power mode 


- Activate the UICC in full power 
mode. 

- EVT FIELD ON 

- EVT CARD ACTIVATED 

- EVT_SEND_DATA (select 
applet) 

- EVT SEND DATA(INS='05') 


getPowerMode ( ) 


return = 
FULL_POWER_MODE 


EVT SEND DATA (SW - 
'90 03') 


N1, 
N3 


2 


Verify power mode 


Activate the UICC in low power 
mode. 

- EVT FIELD ON 

- EVT CARD ACTIVATED 

- EVT_SEND_DATA (select 
applet) 

- EVT SEND DATA(INS='05') 


getPowerMode ( ) 


return = 
LOW_POWER_MODE 


EVT SEND DATA (SW - 
'90 04') 


N1, 
N3 


3 


SWP interface is not activated 


sending command on ISO 

interface: 

- select applet- INS='05' 


getPowerMode ( ) 


Return '-1' 


SW - '90 05' 


N2 



6.1 .1 .3 Method isHCIServiceAvailable 

Test Area Reference: Api_l_Hdv_Isa. 

6.1 .1 .3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

public static byte isHCIServiceAvailable (short servicelD) 

6.1.1.3.1.1 Normal execution 

• CRRNl: this method is used to retrieve information about the availability of a HCIService more related to user 
interface. 

• CRRN2: this method returns (byte)OxOO if the service is available and can be used, otherwise bit values set to: 

bit set: interface not supported by terminal; 

bit 1 set: service not supported by terminal; 

bit 2 set: access not allowed for Applet; 

bit 3 set: HCI interface currently disabled in UICC. 



6.1.1.3.1.2 

• None. 

6.1.1.3.1.3 

• None. 



Parameter errors 



Context errors 
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6.1.1.3.2 



Test suite files 



Applet Name 


Test case ID 


Api 1 Hdv Isa l.java 


1 


Api 1 Hdv Isa l.java 


2 


Api 1 Hdv Isa l.java 


3 


Api 1 Hdv Isa l.java 


4 


Api 1 Hdv Isa 2.java 


5-1 


Api_1_Hdv_lsa_3.java 


5-2 



6.1 .1 .3.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.1.1.3.4 



Test procedure 



Test Case 


ID 


HCI/APDU Command API Description API Expectation HCI/APDU Response CRR 


1 


Retrieve information of an available service 


1 - EVT SEND DATA (INS 
= '06') 


isHCIServiceAvailable { ) 

servicelD = 

CARD_EMULATI ON_S ERVI CE_I D 


0x00 


EVT_SEND_DATA (SW - 
'90 00', data byte set to 
'00') 


N1, 
N2 


2 - EVT SEND DATA (INS 
= '07') 


isHCIServiceAvailable { ) 
servicelD = 
CONNECTIVITY_SERVICE_ID 


0x00 


EVT_SEND_DATA (SW - 
'90 00', data byte set to 
'00') 


N1, 
N2 


3 - Send command on ISO 
interface to select applet; 
the initial conditions in 
clause 6.1.3.1.3 not 
applicable here 
- send APDU INS='08' 


isHCIServiceAvailable { ) 
servicelD = 
READER_SERVICE_ID 


0x00 


SW - '90 00', data byte 
set to '00' 


N1, 
N2 


2 


Interface not supported by terminal 


Precondition: SWP 
interface not supported; the 
initial conditions in clause 
6.1.1.3.1.3 not applicable 
here, and C6 should be 
connected to GND: 

Sending command on ISO 
interface: 

- select applet 

- send APDU (INS = '06') 


isHCIServiceAvailable { ) 


bit set 


- SW - '90 00' 

- SW - '90 00', bit set in 
the data byte 


N2 



£75/ 



Release 9 



25 



ETSI TS 103 115 V9.1.0 (2013-07) 



Test Case 


ID 


HCI/APDU Command API Description 


API Expectation 


HCI/APDU Response 


CRR 


3 


Service not supported by terminal 


1 - Precondition: disable 


isHCIServiceAvailable { ) 


bit 1 set 


EVT_SEND_DATA (SW - 


N2 




Connectivity service 
support in terminal; i.e. 


servicelD = 
CONNECTIVITY_SERVICE_ID 




'90 00', bit 1 set in the 
data byte) 






connectivity gate is not 












available in terminal pipe 












creation is not possible and 












the 












terminal shall indicate in 












TERMINAL PROFILE 












HCI Connectivity is not 












supported. 












- EVT SEND DATA (INS = 












■07') 










2 - Precondition: disable 


isHCIServiceAvailable { ) 


bit 1 set 


SW - '90 00', bit 1 set in 


N2 




Reader service support in 
terminal; i.e. reader RF 


servicelD = 
READER_SERVICE_ID 




the data byte 






gates are not available in 












terminal 












Send command on ISO 












interface to select applet; 












the initial conditions in 












clause 6.1.1.1.3 not 












applicable here 












- send APDU (INS='08') 










4 


Access not allowed for Applet 


1 - Send command on ISO 


isHCIServiceAvailable { ) 


bit 2 set 


SW - '90 00', bit 2 set in 


N2 




interface to select applet; 
the initial conditions in 


servicelD = 

CARD_EMULATI ON_S ERVI CE_I D 




the data byte 






clause 6.1.1.1.3 not 












applicable here 












- select applet 












- send APDU (INS = '06') 










2 - Send command on ISO 


isHCIServiceAvailable { ) 


bit 2 set 


SW - '90 00', bit 2 set in 


N2 




interface to select applet; 
the initial conditions in 


servicelD = 
READER_SERVICE_ID 




the data byte 






clause 6.1.1.1.3 not 












applicable here 












- select applet 












- send APDU (INS = '08') 










5 


HCI interface currently disabled in UICC 


1 - Precondition: 


isHCIServiceAvailable { ) 


bit 3 set 


SW - '90 00', bit 3 set in 


N2 




Contactless functionality 






the data byte 






state is disabled in the 












UICC as defined in TS 102 












223 [7]. Send on ISO 












interface the following 












commands: 












- Send APDU to select the 












applet. 












- Send APDU (INS = '06') 
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Test Case 


ID 


HCI/APDU Command 


API Description 


API Expectation 


HCI/APDU Response 


CRR 




2 - Precondition: 


setCommunicationlnterf ace { ) 


bit 3 set 


SW - '90 04', bit 3 set in 


N2 




Contactless functionality 
state is disabled in the 
UICC as defined in Global 
Platform Amendment C 


API method of Global 
Platform Amendment C [10] 
is used to disable HCI 
interface 




the data byte 






Send on ISO interface send 


isHCIServiceAvailable { ) 










the following commands: 

- Send APDU to select the 
applet. 

- Send APDU (INS = '06') 

- Postcondition: 
Contactless functionality 
state is enabled again in 


setCommunicationlnterf ace { ) 
API method of Global 
Platform Amendment C [10] 
is used to enable again HCI 
interface 










the UICC as defined in 












Global Platform 












Amendment C 











6.1.2 Interface HCIService 
6.1.2.1 Method register 

Test Area Reference: Api_l_Hsr_Reg. 

6.1 .2.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void register {HCIListener listener) 
throws HCIException 

6.1.2.1.1.1 Normal execution 

• CRRNl: registers a Listener object to the Service instance. 

• CRRN2: a certain listener type can only be registered to the same service type. 

• CRRN3: The Registration of Listener Interfaces and activation of events shall be persistent. 

6.1.2.1.1.2 Parameter errors 

• CRRPl: throws HCIException in case the listener Object registered to the service is not implementing the 
corresponding interface of the HCIService instance with error code: 

HCIException.HCI_WRONG_LISTENER_TYPE. 

6.1.2.1.1.3 Context errors 

• CRRCl : throws HCIException with error code HCI_LISTENER_ALREADY_REGISTERED in case a 
listener Object of the same type has already been registered. 
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6.1.2.1.2 



Test suite files 



Applet Name 


Test case ID 


Api 1 Hsr Reg l.java 


1-1 


Api 1 Hsr Reg S.java 


1-2 


Api 1 Hsr Reg S.java 


1-3 


Api 1 Hsr Reg l.java 


2 


Api 1 Hsr Reg 2.java 


3-1 


Api 1 Hsr Reg 4.java 


3-2 


Api 1 Hsr Reg 6.java 


3-3 


Api 1 Hsr Reg l.java 


4 



6.1.2.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.1.2.1.4 



Test procedure 





Test case 


ID 


HCI Command 


Description API Expectation HCI Response CRR 


1 


Register Listener to a service 


1 - 

EVT SEND DATA 

(INS = '09') 


register { ) 
Service = 

CarcJEmulationService 
Listener = 
CarcJEmulationListener 


No exception shall be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1 


2- 

EVT SEND DATA 

(INS = '09') 


register { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 


No exception shall be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1 


3 - Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.1.3 not 
applicable here 
- send APDU 
(INS='09') 


register { ) 

Service = ReacJerService 

Listener = ReacJerListener 


No exception shall be thrown 


SW- '90 00' 


N1 


2 


Register wrong listener type 


EVT SEND DATA 
(INS = 'OA') 


register { ) 

Service = 

Connect ivityService 

Listener = 

CarcJEmulationListener 


Shall throw 

uicc.hci.framework.HCIExceptio 

n with error code 

HCI WRONG LISTENER TYP 

E 


EVT SEND DATA 
(SW- '90 00') 


N2, 
PI 


3 


Listener already registered 


1 - 

EVT SEND DATA 

(INS = 'OB') 


register { ) 
Service = 

CarcJEmulationService 
Listener = 
CarcJEmulationListener 


Shall throw 

uicc.hci.framework.HCIExceptio 

n with error code 

HCI LISTENER ALREADY RE 

GISTERED 


EVT SEND DATA 
(SW- '90 00') 


CI 


2- 

EVT SEND DATA 

(INS = 'OB') 


register { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 


Shall throw 

uicc.hci.framework.HCIExceptio 

n with error code 

HCI LISTENER ALREADY RE 

GISTERED 


EVT SEND DATA 
(SW- '90 00') 


CI 
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Test case 


ID 


HCI Command 


Description 


API Expectation 


HCI Response 


CRR 




3 - Send command 


register { ) 


Shall throw 


SW- '90 00' 


CI 




on ISO interface to 
select applet; the 


Service = ReaderService 
Listener = ReaderListener 


uicc.hci. framework. HCI Exceptio 
n with error code 








initial conditions in 




HCI LISTENER ALREADY RE 








clause 6.1.2.1.3 not 




GISTERED 








applicable here 
- send APDU 












(INS='OB') 










4 


Persistent Listener Registration 


-Send 


register { ) 


Shall throw 


EVT SEND DATA 


N3 




EVT SEND DATA 
(INS = '09') 

- EVT FIELD OFF 

- EVT_FIELD_ON 


Service = 

CardEmulationService 
Listener = 
CardEmulationListener 


uicc.hci. framework. HCI Exceptio 

n with error code 

HCI LISTENER ALREADY RE 

GISTERED 


(SW-'6F01') 






EVT CARD ACTIV 












ATED 












- Select the applet 
-Send 












EVT SEND DATA 












(INS = '09') 











6.1 .2.2 Method deregister 

Test Area Reference: Api_l_Hsr_Drg. 

6.1.2.2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void deregister {HCIListener listener) 

6.1.2.2.1.1 Normal execution 

• CRRNl: deregisters a Listener object from the Service instance. 

• CRRN2: Calling deregister with an argument that does not identify a currently registered HCIListener has no 
effect. 

• CRRN3: Applets communicating through the process() method shall also be able to use the API services 
defined in TS 102 705 [1] which do not require a CardEmulationListener registration (e.g. requesting the 
power mode or connectivity service). 



6.1.2.2.1.2 

• None. 

6.1.2.2.1.3 

• None. 

6.1.2.2.2 



Parameter errors 



Context errors 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hsr Drg l.java 


1 


Api 1 Hsr Drg 2.java 


2 
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6.1.2.2.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.1 .2.2.4 Test procedure 



Test case 


ID 


HCI Command | API Description | API Expectation | HCI Response |CRR 


1 


Deregister Listener to a Service - CardEmulation 


1 - EVT SEND DATA 
(INS = '01') 


register { ) 
Service = 

CardEmulationService 
Listener = 
CardEmulationListener 

deregister { ) 
Service = 

CardEmulationService 
Listener = 
CardEmulationListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N1, 
N3 


2 - EVT SEND DATA 
(INS = '02') 


deregister { ) 

Service = 

Connect ivityService 

Listener = 

CardEmulationListener 


No exception shall 
be thrown 


EVT SEND DATA(SW- 
'90 00') 


N2 


3 - EVT SEND DATA 
(INS = '03') 


deregister { ) 
Service = 

CardEmulationService 
Listener = 
CardEmulationListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N2, 
N3 


2 


Deregister Listener to a Service - Connectivity 


1 - EVT SEND DATA 
(INS = '01') 


register { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 

deregister { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N1 


2 - EVT SEND DATA 
(INS = '02') 


deregister { ) 

Service = 

CardEmulationService 

Listener = 

Connect ivityListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N2 


3 - EVT SEND DATA 
(INS = '03') 


deregister { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N2 



6.1.2.3 Method activateEvent 

Test Area Reference: Api_l_Hsr_Ace. 

6.1.2.3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void activateEvent {byte event) 

throws HCIException 
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6.1 .2.3.1 .1 Normal execution 

• CRRNl: This method is used to activate an event. 

• CRRN2: for all service interfaces HCIListener.EVENT_HCI_TRANSMISSION_FAILED is sent to notify the 
applet when the UICC failed to transmit a message sent by CLF. 

• CRRN3: for all service interfaces HCIListener.EVENT_HCI_RECEPTIONS_F AILED is sent to notify the 
applet when the UICC failed to receive a message sent by CLF. 

• CRRN4: Possible values for event for Card emulation service are: 

EVENT_GET_PARAMETER_RESPONSE. 

EVENT_ON_SEND_DATA. 

EVENT_FIELD_OFF. 

• CRRN5: Possible values for event for Reader service are: 

EVENT_GET_PARAMETER_RESPONSE. 
EVENT_WRITE_EXCHANGE_DATA_RESPONSE. 
EVENT_TARGET_DISCOVERED . 

• CRRN6: Possible value for event for Connectivity service is EVENT_STAND_BY. 

• CRRN7: The Registration of Listener Interfaces and activation of events shall be persistent. 

• CRRN8: When the contactless interface is disabled (cf. "state of contactless functionality" in TS 102 223 [7] 
and setCommunicationlnterfaceO API method of "GlobalPlatform Amendment C" [10]), the Contactless 
Framework shall throw an HCIException with reason code HCI_CURRENTLY_DISABLED. 

• CRRN9: The Contactless Framework shall raise an EVENT_FIELD_OFF if this event is activated for this 
Applet instance, before the invocation of the deselect() method of the Applet instance. 

• CRRNIO: After the EVENT_FIELD_OFF event the Applet instance shall not be triggered by any other event 
until the Applet instance is selected again. 

• CRRN 1 1 : If the current application protocol is APDU based the HCI framework shall handle an application 
session termination according to TS 102 221 [5] independent of the interface used for message exchange. 

• CRRN 12: Applet selection and deselection shall be performed by the Contactless Framework according to the 
rules defined in the "Java Card^"^ Runtime Environment Specification, 3.0 Classic Edition" [11] and in 
"GlobalPlatform Amendment C" [10]. 

• CRRN 13: The select() method of the Applet instance shall always be invoked for an Applet selection 
according to the rules given in "Java Card'"^ Runtime Environment Specification, 3.0 Classic Edition" [11]. 

• CRRN 14: If the HCI event EVT_FIELD_OFF or EVT_CARD_DEACTIVATED defined by the HCI protocol 
as specified in TS 101 220 [4] is received by the Contactless Framework and the UICC is still powered, the 
Applet instance shall be deselected according to "GlobalPlatform Amendment C" [10]. 

6.1.2.3.1.2 Parameter errors 

• CRRPl: HCIException with reason code HCI_WRONG_EVENT_TYPE if a wrong event was activated for 
this service instance. 

• CRRP2: HCIException with reason code HCI_CURRENTLY_DIS ABLED if the interface to the contactless 
frontend (CLF) is currently disabled and the event is ReaderListener.EVENT_TARGET_DISCOVERED. 

6.1.2.3.1.3 Context errors 

• None. 
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6.1.2.3.2 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hsr Ace l.java 


1 


Api 1 Hsr Ace S.java 


2 


Api 1 Hsr Ace 2.java 


3 


Api 1 Hsr Ace l.java 


4 


Api 1 Hsr Ace 7.java 


5-1 


Api_ 1 _Hsr_Ace_9 .j ava 


5-2 


Api 1 Hsr Ace 4.java 


6 


Api 1 Hsr Ace S.java 


7 


Api 1 Hsr Ace 6.java 


8 


Api 1 Hsr Ace S.java 


9 


Api 1 Hsr Ace 6.java 


10 



6.1.2.3.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 



6.1.2.3.4 



Test procedure 



Test Case 


ID 


HCI Command 


Description API Expectation 


HCI Response 


CRR 


1 


Event activation - CardEmulationService 


1 - EVT SEND DATA(INS = 
'10') 


HCIListener = 
CardEmulationListener 
HCIService = 


No exception shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N2 






CardEmulationService 












activateEvent ( ) 












event = 












HCIListener. EVENT HCI TRANSMI 












SSION FAILED 








2 - EVT SEND DATA{INS = 
'11') 


HCIListener = 
CardEmulationListener 
HCIService = 


No exception shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N3 






CardEmulationService 












activateEvent ( ) 












event = 












HCIListener. EVENT HCI RECEPTI 












ONS FAILED 








3 - EVT SEND DATA(INS = 
'12') 


HCIListener = 
CardEmulationListener 
HCIService = 


No exception shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N4 






CardEmulationService 












activateEvent ( ) 












event = 












CardEmulationListener .EVENT G 












ET PARAMETER RESPONSE 








4- 

- EVT SEND DATA(INS = 

'14') 


HCIListener = 
CardEmulationListener 
HCIService = 


No exception shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N4 




CardEmulationService 












activateEvent ( ) 












event = 












CardEmulationListener .EVENT 












N SEND DATA 
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Test Case 


ID 


HCI Command Description API Expectation HCI Response CRR 


2 


Event activation - ReaderService 


1 - EVT SEND DATA (INS = 
■11') 


HCIService = ReaderService 

activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_RECEPTI 

ONS FAILED 


No exception shall 
be thrown. 


SW - '90 00^ 


N1, 
N3 


2- Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
-SendAPDU INS='11' 


HCIService = ReaderService 

activateEvent ( ) 

event = 

EVENT_TARGET_DISCOVERED 


No exception shall 
be thrown. 


SW - ■90 00^ 


N1, 
N5 


3 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
-SendAPDU INS='12' 


HCIService = ReaderService 

activateEvent ( ) 

event = 

EVENT WRITE EXCHANGE DATA RES 

PONSE 


No exception shall 
be thrown. 


SW - ^90 00^ 


N1, 
N5 


4 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
-SendAPDU INS='13' 


HCIService = ReaderService 

activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_TRANSMI 

SSION FAILED 


No exception shall 
be thrown. 


SW - ^90 00^ 


N1, 
N2. 


5 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
-SendAPDU INS='14' 


HCIService = ReaderService 

activateEvent ( ) 

event = 

EVENT GET PARAMETER RESPONSE 


No exception shall 
be thrown. 


SW - ^90 00^ 


N1, 
N5 


3 


Event activation - ConnectivityListener 


1 - EVT SEND DATA(INS = 
■10') 


HCIListener = 
ConnectivityListener 
HCIService = 
Connect ivityService 

activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_TRANSMI 

SSION FAILED 


No exception shall 
be thrown. 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N2 


2 - EVT SEND DATA(INS = 
■11') 


HCIListener = 
ConnectivityListener 
HCIService = 
Connect ivityService 

activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_RECEPTI 

ONS FAILED 


No exception shall 
be thrown. 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N3 


3 - EVT SEND DATA(INS = 
■12') 


HCIListener = 
ConnectivityListener 
HCIService = 
Connect ivityService 

activateEvent ( ) 

event = EVENT STAND BY 


No exception shall 
be thrown. 


EVT SEND DATA 
(SW- '90 00') 


N1, N6 


4 


Wrong event type 


EVT SEND DATA (INS = 
■16') 


HCIListener = 
CardEmulationListener 
HCIService = 
CardEmulationService 

activateEvent ( ) 
event value = 0x02 


HCIException with 
reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


PI 
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Test Case 


ID 


HCI Command 


Description API Expectation 


HCI Response 


GRR 


5 


HCI is disabled 


1- Precondition: Contactless 


HCIService = ReaderService 


HCIException with 


SW- '90 00' 


P2, N8 




functionality state is disabled 


activateEvent ( ) 


reason code 








in the UICC as defined in 


event = 


HCI CURRENTLY 








TS 102 223 [7]. Send on ISO 


ReaderListener .EVENT TARGET D 
ISCOVERED 


_DISABLED shall 








interface the following 




be thrown 








commands 












- Send APDU to select the 












applet. 












- Send APDU 












(INS = '01') on ISO interface 












2 - Precondition: Contactless 


setCommunicationlnterf ace ( ) 


HCIException with 


SW- '90 00' 


P2, N8 




functionality state is disabled 


API method of "GlobalPlatf orm 


reason code 








in the UICC as defined in 


Amendment C" [10] used to 


HCI CURRENTLY 








Global Platform Amendment 


disable HCI interface 
HCIService = ReaderService 


_DISABLED shall 








C. Send on ISO interface 


activateEvent ( ) 


be thrown 








send the following 


event = 










commands: 


ReaderListener . EVENT_TARGET_D 










- Send APDU to select the 


ISCOVERED 










applet. 

-Send APDU (INS = '01') on 


setCommunicationlnterf ace ( ) 
API method of Global 










ISO interface 


Platform Amendment C [10] is 










- Postcondition: 


used to enable again HCI 










Contactless functionality 


interface 










state is enabled again in the 












UICC as defined in Global 












Platform Amendment C 










6 


Persistent Event Activation 


-Send 


Service = 




- 


N7 




EVT SEND DATA (INS = 


CardEmulationService 


No exception shall 


EVT SEND DATA 






'01') 


Listener = 
CardEmulat ionListener 


be thrown. 


(SW- '90 00') 






- EVT_FIELD_OFF 




getEventNotificatio 


- 






- Power off 


activateEvent (EVENT FIELD OFF 


nStatusO = true 


EVT SEND DATA 






- Power on 


) 




(SW- '90 00') 






- EVT FIELD ON 












- EVT_CARD_ACTIVATED 












- Select the applet 












- Send EVT SEND DATA 












(INS = '02') 










7 


Event Field Off before deselect 


- EVT FIELD OFF 


Service = 


EVENT_FIELD_OF 


EVT SEND DATA 


N9, 




- EVT FIELD ON 


CardEmulationService 


F raised before 


(SW- '90 00') 


Nil, 




- EVT_CARD_ACTIVATED 


Listener = 


deselectO 




N12, 




- Select the applet 


CardEmulat ionListener 
activateEvent (EVENT ON SEND D 






N14 




- Send EVT SEND DATA 


ATA) during the installation 










(INS = '01') 


onCallbackO 

activateEvent ( ) 

event = EVENT_FIELD_OFF 

deselect ( ) 








8 


No triggering after Event Field Off 


EVT FIELD OFF 


Service = 


EVENT ON SEN 


No response, or 


N1, 




- Send EVT SEND DATA 


CardEmulationService 


D_DATA shall not 


EVT_SEND_DATA 


N4, 




(INS = '01') 


Listener = 
CardEmulat ionListener 


be raised 


with any response 
except: 


N10, 
N11 






activateEvent (EVENT_ON_SEND_D 








ATA) during the installation 




(SW - '90 00') 








onCallback () 












activateEvent 












event = EVENT FIELD OFF 








9 


Check for Selection 


Send EVT SEND DATA 


Service = 


Check for 


EVT SEND DATA 


N12, 




(INS = '01') 


CardEmulationService 
Listener = 


invocation of 
selectO 


(SW - '90 00') 


N13 






CardEmulat ionListener 
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Test Case 


ID 


HCI Command 


Description API Expectation 


HCI Response CRR 


10 


No triggering after Event Card Deactivate 


EVT CARD DEACTIVATE 
- Send EVT SEND DATA 
(INS = '01') 


Service = 

CardEmulationService 
Listener = 

CardEmulationListener 
activateEvent (EVENT_ON_SEND_D 
ATA) during the installation 
onCallback () 

activateEvent ( ) 

event = EVENT FIELD OFF 


EVT_SEND_DATA 
shall not be raised 


No response or 

EVT_SEND_DATA 

withany response 

except: 

(SW - '90 00' or '6D 

00') 


N12, 
N14 



6.1 .2.4 Method deactivateEvent 

Test Area Reference: Api_l_Hsr_Dae. 

6.1.2.4.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void deactivateEvent {byte event) 

throws HCIException 

6.1.2.4.1.1 Normal execution 

• CRRNl: deactivates an event from the list of activated events. 

• CRRN2: for all service interfaces HCIListenr.EVENT_HCI_TRANSMISSION_F AILED is sent to notify the 
applet when the UICC failed to transmit a message sent by CLE. 

• CRRN3: for all service interfaces HCIListenr HCIListener.EVENT_HCI_RECEPTIONS_F AILED is sent to 
notify the applet when the UICC failed to receive a message sent by CLE. 

• CRRN4: Possible values for parameter event for Card emulation service are: 

EVENT_GET_PARAMETER_RESPONSE. 

EVENT_ON_SEND_DATA. 

EVENT_EIELD_OEE. 

• CRRN5: Possible values for parameter event for Reader service are: 

EVENT_GET_PARAMETER_RESPONSE. 
EVENT_WRITE_EXCHANGE_DATA_RESPONSE. 
EVENT_TARGET_DISCOVERED . 

• CRRN6: Possible values for Connectivity service is EVENT_STANDBY. 



6.1.2.4.1.2 



Parameter errors 



CRRPl: HCIException with reason code HCIException.HCI_WRONG_EVENT_TYPE in case a wrong event 
was deactivated for this service instance. 

CRRP2: HCIException with reason code.HCI_WRONG_EVENT_TYPE in case the event wasn't activated 
before. 



6.1.2.4.1.3 
• None. 



Context errors 
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6.1.2.4.2 



Test suite files 



Applet Name 


Test case ID 


Api 1 Hsr Dae l.java 


1-1 


Api 1 Hsr Dae l.java 


1-2 


Api 1 Hsr Dae 2.java 


1-3 


Api 1 Hsr Dae 2.java 


1-4 


Api 1 Hsr Dae S.java 


2 


Api 1 Hsr Dae 4.java 


3 


Api 1 Hsr Dae l.java 


4 


Api 1 Hsr Dae S.java 


5 


Api 1 Hsr Dae 6.java 


6 


Api 1 Hsr Dae 7.java 


7 



6.1.2.4.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.1.2.4.4 



Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response CRR 


1 


Event deactivation - CardEmulationService 


1 - 


HCIService = 


No exception shall 


EVT SEND DAT 


N1,N2 




EVT_SEND_DATA(INS='1 0') 


CardEmulationService 
Event has been 
successfully activated 

deactivateEvent { ) 
event = 

HCIListener . EVENT_HCI_TRA 
NSMISSION FAILED 


be thrown 


A (SW- '90 00') 




2- 


HCIService = 


No exception shall 


EVT SEND DAT 


N1, N3 




EVT_SEND_DATA(INS='1 1 ') 


CardEmulationService 
Event has been 
successfully activated 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_REC 

EPTIONS FAILED 


be thrown 


A (SW- '90 00') 




3- 


HCIService = 


No exception shall 


EVT SEND DAT 


N1, N4 




EVT_SEND_DATA(INS='1 2') 


CardEmulationService 
Event has been 
successfully activated 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT GET PARAMETER RESPONSE 


be thrown 


A (SW- '90 00') 




4- 


HCIService = 


No exception shall 


EVT SEND DAT 


N1,N4 




EVT_SEND_DATA(INS='1 4') 


CardEmulationService 
Event has been 
successfully activated 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT ON SEND DATA 


be thrown 


A (SW- '90 00') 
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Test case 



ID 



HCI Command 



API Description 



API Expectation | HCI Response | CRR 



Event deactivation - ReaderService 



1- Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
- Send APDU (INS='09') 



HCIService = 
ReaderService 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_TRA 

NSMISSION FAILED 



No exception shall 
be thrown 



SW-'90 00' N1,N2 



2 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.4.3 not applicable here 
-Send APDU (INS='10') 



HCIListener = 
ReaderListener 
HCIService = 
ReaderService 
Event has been 
successfully activated 

deactivateEvent { ) 
event = HCIListener. 
EVENT_HCI_TRANSMISSION_FA 
ILED 



No exception shall 
be thrown 



SW - '90 00' 



N1,N3 



3 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.4.3 not applicable here 
-Send APDU (INS='11') 



HCIListener = 
ReaderListener 
HCIService = 
ReaderService 
Event has been 
successfully activated 

deactivateEvent { ) 
event = 

EVENT_GET_PARAMETER_RES PO 
NSE 



No exception shall 
be thrown 



SW - '90 00' 



N1, N5 



4 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.4.3 not applicable here 
-Send APDU (INS='12') 



HCIListener = 
ReaderListener 
HCIService = 
ReaderService 

deactivateEvent { ) 
event = 

EVENT_WRITE_EXCHANGE_DATA 
RESPONSE 



No exception shall 
be thrown 



SW - '90 00' 



N1,N5 



5- Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.4.3 not applicable here 
-Send APDU (INS='13') 



HCIListener = 
ReaderListener 
HCIService = 
ReaderServiceEvent has 
been successfully 
activated 

deactivateEvent { ) 

event = 

EVENT TARGET DISCOVERED 



No exception shall 
be thrown 



SW - '90 00' 



N1, N5 



Event deactivation - ConnectivityService 



1 - 
EVT_SEND_DATA(INS='1 0') 



HCIListener = 
Connect ivityListener 
HCIService = 
ConnectivityService 
Event has been 
successfully activated 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_TRA 

NSMISSION FAILED 



No exception shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



N1,N2 



EVT_SEND_DATA(INS='1 1 ') 



HCIListener = 
Connect ivityListener 
HCIService = 
ConnectivityService 
Event has been 
successfully activated 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_REC 

EPTIONS FAILED 



No exception shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N3 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 




3- 


HCIListener = 


No exception shall 


EVT SEND DAT 


N1, 




EVT SEND DATA(INS='12') 


Connect ivityListener 


be thrown 


A (SW- '90 00') 


N6 






HCIService = 
ConnectivityService 
Event has been 
successfully activated 

deactivateEvent { ) 

event = EVENT STAND BY 








4 


Wrong event type 


EVT SEND DATA (INS = '16') 


HCIService = 


HCIException with 


EVT SEND DAT 


PI 






CardEmulationService 


reason code 


A (SW- '90 00') 








Event has been 


HCI WRONG EV 










successfully activated 


ENT TYPE shall 










deactivateEvent { ) 


be thrown 










event value = 02 








5 


Deactivate an non-active event - CardEmulationService 


1 - EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'10') 


CardEmulationService 

Event was not activated 

before 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_TRA 

NSMISSION FAILED 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




2 - EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'11') 


CardEmulationService 
Event was not activated 
before 

deactivateEvent { ) 
event = 

HCIListener . EVENT_HCI_REC 
EPTIONS FAILED 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




3 - EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'12') 


CardEmulationService 
Event was not activated 
before 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT GET PARAMETER RESPONSE 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




4 -EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'13') 


CardEmulationService 
Event was not activated 
before 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT FIELD OFF 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




5- EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'14') 


CardEmulationService 
Event was not activated 
before 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT ON SEND DATA 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




6 


Deactivate an non-active event - ConnectivityService 


EVT SEND DATA(INS='12') 


HCIListener = 


HCIException with 


EVT SEND DAT 


P2 






Connect ivityListener 


reason code 


A (SW- '90 00') 








HCIService = 


HCI WRONG EV 










ConnectivityService 
Event was not activated 


ENT_TYPE shall 










before 


be thrown 










deactivateEvent {) 












event = EVENT STAND BY 
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Test case 



ID 



HCI Command 



API Description 



API Expectation | HCI Response | CRR 



Deactivate an non-active event - ReaderService 



1 - 
EVT_SEND_DATA(INS='1 0') 



HCIListener = 

ReaderListener 

HCIService = 

ReaderService 

Event was not activated 

before 

deactivateEvent { ) 
event = 

EVENT_GET_PARAMETER_RES PO 
NSE 



HCIException with 
reason code 
HCI_WRONG_EV 
ENT_TYPE shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



P2 



EVT_SEND_DATA(INS='1 1 ') 



HCIListener = 

ReaderListener 

HCIService = 

ReaderService 

Event was not activated 

before 

deactivateEvent { ) 
event = 

EVENT_WRITE_EXCHANGE_DATA 
RESPONSE 



HCIException with 
reason code 
HCI_WRONG_EV 
ENT_TYPE shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



P2 



EVT_SEND_DATA(INS='1 2') 



HCIListener = 

ReaderListener 

HCIService = 

ReaderService 

Event was not activated 

before 

deactivateEvent { ) 

event = 

EVENT TARGET DISCOVERED 



HCIException with 
reason code 
HCI_WRONG_EV 
ENT_TYPE shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



P2 



6.1.2.5 Method requestCallbackNotification 

Test Area Reference: Api_l_Hsr_Rcn. 

6.1.2.5.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void requestCallbackNotification {byte event) 

throws HCIException 

6.1.2.5.1.1 Normal execution 

• CRRNl : the call of this method trows HCIException with reason code HCI_ACCESS_NOT_GRANTED. 

6.1.2.5.1.2 Parameter errors 

• None. 



6.1.2.5.1.3 
• None. 

6.1.2.5.2 



Context errors 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hsr Ren 7.java 


1 
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6.1.2.5.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.1 .2.5.4 Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation | HCI Response | CRR 



Request Callback Notification 



EVT_SEND_DAT 
A (INS = '10') 



Precondition : 

HCIService = 

CardEmulationService 

Corresponding listener 

registered 

No event is activated 

requestCallbackNotif ication {) 
event = 

HCIListener . EVENT_HCI_TRANSMISS 
ION FAILED 



throws HCIexception 
with reason code 
HCI_ACCESS_NOT_ 
GRANTED 



EVT_SEND_DAT 
A (SW- '90 00') 



N1 



6.1 .2.6 Method getEventNotificationStatus 

Test Area Reference: Api_l_Hsr_Gen. 

6.1.2.6.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

boolean getEventNotificationStatus {byte event) 

throws HCIException 

6.1 .2.6.1 .1 Normal execution 

• CRRNl: return the activation state of an event; if true the event is activated for this listener, else false. 

• CRRN2: For CardEmulationService:EVENT_GET_PARAMETER_RESPONSE, EVENT_SEND_DATA, 
and EVENT_FIELD_OFF. 

• CRRN3: For ReaderService: EVENT_GET_PARAMETER_RESPONSE, 
EVENT_WRITE_EXCHANGE_DATA_RESPONSE, and EVENT_TARGET_DISCOVERED. 

• CRRN4: For ConnectivityService: ConnectivityListener.EVENT_STANDBY. 

• CRRN5: For all service interfaces: HCIListener.EVENT_HCI_TRANSMISSION_F AILED 
HCIListener.EVENT_HCI_RECEPTIONS_FAILED. 



6.1.2.6.1.2 



Parameter errors 



CRRPl: HCIException with reason code HCIException.HCI_WRONG_EVENT_TYPE in case the event was 
not one of the possible values. 



6.1.2.6.1.3 
• None. 



Context errors 
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6.1.2.6.2 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hsr Gen l.java 


1 


Api 1 Hsr Gen l.java 


2 


Api 1 Hsr Gen S.java 


3 


Api 1 Hsr Gen S.java 


4 


Api 1 Hsr Gen l.java 


5-1 


Api 1 Hsr Gen S.java 


5-2 


Api 1 Hsr Gen 2.java 


5-3 


Api 1 Hsr Gen 2.java 


6 


Api_1_Hsr_Gen_2.java 


7 



6.1.2.6.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 



6.1.2.6.4 



Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response | CRR 



Event notification status false - CardEmulationService 



1 - 

EVT_SEND_DATA 
(INS = '10') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus ( ) 
event = 

HCIListener . EVENT_HCI_TRANSM 
ISSION FAILED 



No exception sliall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N5 



EVT_SEND_DATA 
(INS = '11') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus () 
event = 

HCIListener . EVENT_HCI_RECEPT 
IONS FAILED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N5 



EVT_SEND_DATA 
(INS = '12') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus ( ) 
event = 

CardEmulat ionListener . EVENT_ 
GET PARAMETER RESPONSE 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N2 



4- 

EVT_SEND_DATA 
(INS = 'IS') 



4 HCIService = 
CardEmulationService 

getEventNotif icationStatus () 
event = 

CardEmulationListener . 
EVENT FIELD OFF 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N2 



5- 

EVT_SEND_DATA 
(INS = '14') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus () 
event = 

CardEmulationListener . 
EVENT ON SEND DATA 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N2 
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Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


2 


Event notification status true - CardEmulationService 


EVT SEND DATA 


HCIService = 






N1, N2 




(INS = '15') 


CardEmulationService 

activateEvent ( ) 

event = 

CardEmulat ionListener . EVENT 

ON_SEND_DATA 

getEventNotif icationStatus 

event = 


No exception shall be thrown. 

getEventNotificationStatusO = 
true 


EVT SEND DAT 
A (SW- '90 00') 


















CardEmulat ionListener . EVENT_ 












ON SEND DATA 








3 


Event notification status true - ReaderService 


1 - Send command 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N3 




on ISO interface to 


activateEvent ( ) 










select applet; the 
initial conditions in 
clause 6.1.2.6.5 


event = 

ReaderListener . 

EVENT WRITE EXCHANGE DATA RE 

SPONSE 


getEventNotificationStatusO = 
true 








not applicable here 












- Send APDU (INS 


getEventNotif icationStatus () 










= '21') 


event = 

ReaderListener . 

EVENT_WRITE_EXCHANGE_DATA_RE 
SPONSE 








2 - Send command 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N3 




on ISO interface to 












select applet; the 
initial conditions in 
clause 6.1.2.6.5 


activateEvent ( ) 

event = 

ReaderListener . EVENT_TARGET_ 

DISCOVERED 


getEventNotificationStatusO = 
true 








not applicable here 












Send APDU (INS 


getEventNotif icationStatus () 










= '22') 


event = 

ReaderListener .EVENT TARGET 

DISCOVERED 








3 - Send APDU 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N3 




(INS = '23') 


activateEvent ( ) 
event = 
ReaderListener . 


getEventNotificationStatusO = 
true 










EVENT_GET_PARAMETER_RESPONSE 










getEventNotif icationStatus ( ) 












event = 












ReaderListener . 












EVENT GET PARAMETER RESPONSE 








4 - Send command 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N5 




on ISO interface to 


activateEvent () 










select applet; the 
initial conditions in 
clause 6.1.2.6.5 


event = 

ReaderListener . 

EVENT_HCI_RECEPTIONS_FAILED 


getEventNotificationStatusO = 
true 








not applicable here 


getEventNotif icationStatus ( ) 










-Send APDU (INS 


event = 










= '24') 


ReaderListener . 

EVENT HCI RECEPTIONS FAILED 








5- Send command 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N5 




on ISO interface to 


activateEvent ( ) 










select applet; the 
initial conditions in 
clause 6.1.2.6.5 


event = 

ReaderListener . 

EVENT HCI TRANSMISSION FAILE 

D 


getEventNotificationStatusO = 
true 








not applicable here 












-Send APDU (INS 


getEventNotif icationStatus () 










= '25') 


event = 

ReaderListener . 

EVENT_HCI_TRANSMISSION_FAILE 
D 
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Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response | CRR 



Event notification status false - ReaderService 



1 - Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
- Send APDU 
(INS='10') 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 
event = HCIListener. 
EVENT_HCI_TRANSMISSION_FAILE 
D 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N5 



2 - Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
-Send APDU (INS 

^^m 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 

event = 

EVENT GET PARAMETER RESPONSE 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N3 



3 - Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
- Send APDU 
(INS='12') 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 
event = 

EVENT_WRITE_EXCHANGE_DATA_RE 
SPONSE 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N3 



4- Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
-Send APDU (INS 
= ■13') 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 

event = 

EVENT TARGET DISCOVERED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N3 



5- Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
- Send APDU 
(INS='14') 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 

event = 

EVENT HCI RECEPTION FAILED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N3 



Wrong event type 



1- 

EVT_SEND_DATA 
(INS = '16') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus ( ) 
event = 0x02 



HCIException with reason 
code 

HCI_WRONG_EVENT_TYPE 
shall be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



P1 



2- Send on ISO 

interface 

-Send APDU (INS 



HCIService = ReaderService 

getEventNotif icationStatus ( ) 
event = 0x84 



HCIException with reason 
code 

HCI_WRONG_EVENT_TYPE 
shall be thrown 



SW - '90 00' 



P1 



3- 

EVT_SEND_DATA 
(INS = '16') 



HCIService = 
Connect ivityService 

getEventNotif icationStatus ( ) 
event = 0x02 



HCIException with reason 
code 

HCI_WRONG_EVENT_TYPE 
shall be thrown 



EVT_SEND_DAT 
A (SW - '90 00') 



P1 
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Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response | CRR 



Event notification status false - ConnectivityService 



1 - 

EVT_SEND_DATA 
(INS = '10') 



HCIListener = 
Connect ivityListener 
HCIService = 
ConnectivityService 

getEventNotif icationStatus () 
event = 

HCIListener . EVENT_HCI_TRaNSM 
ISSION FAILED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW - '90 GO') 



N1, N5 



2- 

EVT_SEND_DATA 
(INS = '11') 



HCIListener = 
Connect ivityListener 
HCIService = 
ConnectivityService 

getEventNotif icationStatus ( ) 
event = 

HCIListener . EVENT_HCI_RECEPT 
IONS FAILED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW - '90 GO') 



N1, N5 



EVT_SEND_DATA 
(INS = '12') 



HCIListener = 
Connect ivityListener 
HCIService = 
ConnectivityService 

getEventNotif icationStatus ( ) 
event = 

Connect ivityListener . EVENT_S 
TAND BY 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW - '90 GO') 



N1, N4 



Event notification status true - ConnectivityService 



EVT_SEND_DATA 
(INS = '15') 



HCIListener = 
Connect ivityListener 
HCIService = 
ConnectivityService 

activateEvent ( ) 

event = 

Connect ivityListener . EVENT_S 

TAND_BY 

getEventNotif icationStatus ( ) 
event = 

Connect ivityListener . EVENT_S 
TAND BY 



No exception shall be thrown. 

getEventNotificationStatusO = 
true 



EVT_SEND_DAT 
A (SW - '90 GO') 



N1, N4 



6.1.3 Interface HCI Message 

6.1.3.1 Method isHeading 

Test Area Reference: Api_l_Hme_Mhd. 

6.1 .3.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

boolean isHeading {) 



6.1.3.1.1.1 



Normal execution 



CRRNl: Checks if the current content is the heading part of an HCP message The heading information 
indicates the first part of an HCP message; with the isComplete() method it is possible to check whether the 
complete message has already been received. 

CRRN2: returns true if the current message is the heading part of the message. 

CRRN3: An HCIMessage object shall encapsulate one HCP message according to the HCI protocol as 
specified in TS 102 622 [3]. 
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• CRRN4: HCI message for the different contactless modes shall be identified by different types of interfaces. 

• CRRN5: In case the Applet instance has registered the CardEmulationListener and has activated the 
EVENT_ON_SEND_DATA the process() method of this Applet instance shall not be invoked during the 
selection. 

6.1.3.1.1.2 Parameter errors 

• None. 

6.1.3.1.1.3 Context errors 

• None. 



6.1.3.1.2 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hme Mhd l.java 


1 



6.1.3.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 

6.1.3.1.4 Test procedure 

Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response 



CRR 



message is complete 



EVT_SEND_DATA 
(INS ='01') 



onCallbackO 

event = 

E VENT_ON_S END_DATA 

HCIMessage . isHeading { ) 



No exception shall 
be thrown. 

isHeading = 
true 



EVT_SEND_DATA (SW - '90 00') 

Result returned in the first response 
byte of the R-APDU data: b1 is set 



N1, 
N2, 
N3, 
N4, 
N5 



6.1.3.2 MethodisComplete 

Test Area Reference: Api_l_Hme_Mco. 

6.1.3.2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

boolean isCompleteO 



6.1.3.2.1.1 



Normal execution 



• CRRNl: this method checks for the completeness of the HCP message, i.e. the last received HCP packet had 
the chaining bit CB set to 1 . It returns true if the message is complete. 

• CRRN2: the framework shall copy data into the receive buffer up to the end of the buffer. When the HCI 
message is longer than the available buffer length the HCIMessage shall be set as not complete. 



6.1.3.2.1.2 
• None. 



Parameter errors 
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6.1.3.2.1.3 
• None. 

6.1.3.2.2 



Context errors 



Test suite files 



Applet Name 


Test case ID 


Api 1 Hme Mco l.java 


1 



6.1.3.2.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 

6.1.3.2.4 



Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response 



CRR 



message is complete 



EVT_SEND_DATA 
(INS = '01') 



onCallbackO 

event = 

E VENT_ON_S END_D ATA 

HCIMessage . isComplete { ) 



No exception shall 
be thrown. 

isComplete ( ) = 
true 



EVT_SEND_DATA (SW 
- '90 00') 

Result returned in the 
second response byte of 
the R-APDU data: b1 is 
set 



N1 



6.1.3.3 Method getType 

Test Area Reference: Api_l_Hme_Mty. 

6.1.3.3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 



byte getType { ) 



6.1.3.3.1.1 



Normal execution 



CRRNl: Returns the type of the incoming HCI message, it shall be one of constant values TYPE_defined in 
this interface. The returned type possibilities are: TYPE_COMMAND Indicates the HCI message type 
"command", TYPE_EVENT Indicates the HCI message type "event" and TYPE_RESPONSE indicates the 
HCI message type "response". 

CRRN2: In the case of a fragmented incoming message this method shall return the HCI message type coded 
in the first part of the HCI message. 



6.1.3.3.1.2 

• None. 

6.1.3.3.1.3 

• None. 



Parameter errors 



Context errors 
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6.1.3.3.2 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hme Mty l.java 


1 


Api 1 Hme Mty 2.java 


2 



6.1.3.3.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.1 .3.3.4 Test procedure 

Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response | CRR 



message of type event - Card emulation 



EVT_SEND_DATA 
(INS = '01') 



onCallbackO 

event = EVENT_ON_SEND_DATA 

HCIMessage.getType 



No exception shall be 
thrown. 

getlype {) = 
TYPE EVENT 



EVT_SEND_DATA 
(SW - '90 00') 

third response byte 
of the R-APDU data 
is '40' 



N1 



message of type event - Connectivity 



- Send command on 
ISO interface to select 
applet; the initial 
conditions in clause 
6.1.3.3.3 not 
applicable here 

- EVT_STANDBY 

- Send on ISO 
interface (INS = '01') 



extends ConnectivityListener 

activateEvent ( ) 

event = EVENT_STAND_BY 

onCallback ( ) 

event = EVENT_STAND_BY 

HCIMessage . getType ( ) 



No exception shall be 
thrown. 

getType () = 
TYPE EVENT 



SW = '90 00' 

third response byte 
of the R-APDU data 
is '40' 



N1 



6.1.3.4 Method getlnstruction 

Test Area Reference: Api_l_Hme_Min. 

6.1.3.4.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

byte getlnstruction { ) 



6.1.3.4.1.1 



Normal execution 



• CRRNl: returns the instruction part of the HCP message header of the current incoming HCP message, see 
TS 102 622 [3] for further information. It returns the message instruction, b8,b7 of the return value are set to 
zero. 

6.1.3.4.1.2 Parameter errors 

• None. 

6.1.3.4.1.3 Context errors 

• None. 
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Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hme Min l.java 


1 


Api 1 Hme Min 2.java 


2 



6.1.3.4.3 initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 

6.1 .3.4.4 Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


1 


message of type event: Card emulation 


EVT SEND DATA 


onCallbackO 


No exception shall be 


EVT SEND DATA 


N1 




(INS = '01') 


event = EVENT_ON_SEND_DATA 
HCIMessage .getlnstruction ( ) 


thrown. 
getlnstructionO = '10' 


(SW - '90 00') 
the 4th response 
byte of the R-APDU 
data is '10' 




2 


message of type response: Card emulation 


- EVT SEND DATA 


onCallback () 


No exception shall be 


- EVT SEND DATA 


N1 




(INS = '01') 


prepareAndSendGetParameterComman 


thrown. 


(SW - '90 00') 






- ANY OK(ATQA) 
- EVT_SEND_DATA 


d() 

parameter = 

PARAM ID TYPE A CARD ATQA 


getlnstructionO = '00' 


ANY GET PARAM 






(arbitrary data) 


onCallback 
event = 

EVENT_GET_PARAMETER_RESPONSE 
HCIMessage .getlnstruction () 




TER(ATQA) 

- EVT SEND DATA 

(SW - '90 00') 

the 4th response 
byte of the R-APDU 
data is '00' 





6.1.3.5 Method getReceiveOffset 

Test Area Reference: Api_l_Hme_Mro. 

6.1.3.5.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

short getReceiveOf f set { ) 



6.1.3.5.1.1 



Normal execution 



• CRRNl: this method returns the offset of the received HCI message data in the receive buffer, retrieved via 
getReceiveBuffer(). 



6.1.3.5.1.2 
• None. 



Parameter errors 



Context error 



6.1.3.5.1.3 
• None. 
NOTE: This method is implicitly tested in clause 6.1.3.7. 
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6.1.3.6 Method getReceiveLength 

Test Area Reference: Api_l_Hme_Mrl. 

6.1.3.6.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

short getReceiveLength { ) 



6.1.3.6.1.1 



Normal execution 



• CRRNl: this method returns the length of the received HCI message data. It is the size of the message data 
available in the receive buffer. 

6.1.3.6.1.2 Parameter errors 

• None. 

6.1.3.6.1.3 Context error 

• None. 



6.1.3.6.2 



Test Suite Files 



Applet Name 


Test case ID 


Api_1_Hme_Mrl_1 .Java 


1 



6.1.3.6.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.1 .3.6.4 Test procedure 

Test case 



API Description 



HCI Response |CRR 



ID 



HCI Command 



*l Description | API Expectation | 

received message length: CardEmulationService 

c{) Nn fixnfintinn .qhall FVT 



Get 



EVT_SEND_DATA: 
Send message with 
the length 'OA' 
message is complete 



onCallback { ) 

event = EVENT_ON_SEND_DATA 

HCIMessage . getReceiveLength { ) 



No exception shall 
be thrown. 

getReceiveLengthQ 
= '0A' 



EVT_SEND_DATA (SW - 
'90 00') 

Result returned in the 7th 
and 8th response byte of 
the R-APDU data ('00 OA') 



N1 



6.1 .3.7 Method getReceiveBuffer 

Test Area Reference: Api_l_Hme_Mrb. 

6.1.3.7.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

byte [] getReceiveBuf f er { ) 
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6.1.3.7.1.1 



Normal execution 



CRRNl: returns a reference to the underlying HCI message receive buffer. The length of this buffer is system 
dependent; it is guaranteed to be at least 270 bytes. 

CRRN2: it returns the buffer holding the current HCI message. 

CRRN3: the content of the array starts at the location indicated by getReceiveOffset() and has the length 
indicated by getReceiveLength(). 



6.1.3.7.1.2 


Parameter errc 


• None. 




6.1.3.7.1.3 


Context errors 


• None. 




6.1.3.7.2 


Test suite files 



Applet Name 


Test case ID 


Api 1 Hme Mrb l.java 


1 



6.1.3.7.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.1.3.7.4 



Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response 



CRR 



Message length < 270 bytes 



EVT_SEND_DATA (message 
with the length = 09: '00 01 02 
03 04 05 06 07 08') 



onCallbackO 
event = 

E VENT_ON_S END_D ATA 
getReceiveBuf f er { ) 
getReceiveOf f set { ) 
getReceiveLength { ) 



No exception shall be 

thrown. 

First 9 bytes of 

getReceiveBufferO shall be 

'00 01 02 03 04 05 06 07 08 



EVT_SEND_DATA () 

First 9 bytes of the 
response data shall be '00 
01 02 03 04 05 06 07 08' 



N1, 
N2, 
N3 



6.1.4 Class HCI Exception 



6.1.4.1 Method throwit 

Test Area Reference: Api_l_Hxp_Trw. 

6.1 .4.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

public static void throwit {short reason) 
throws HCIException 

6.1 .4.1 .1 .1 Normal execution 

• CRRNl: Throws the JCRE owned instance of the HCIException with the specified reason code. 
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6.1.4.1.1.2 Parameter errors 

• None. 

6.1.4.1.1.3 Context errors 

• None. 



6.1.4.1.2 



Test suite files 



Applet Name 


Test case ID 


Api_1_Hxp_Trw_1 .Java 


1 



6.1.4.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 

6.1.4.1.4 Test procedure 

Test Case 



ID 



HCI Command 



API Description 



API Expectation | HCI Response | CRR 



Throw Exception 



1 - EVT_SEND_DATA 
(INS = '01') 



throwit 

reason = HCI ACCESS NOT GRANTED 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



2 - EVT_SEND_DATA 
(INS = '02') 



throwit 

reason = HCI CONDITIONS NOT SATISFIED 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



3 - EVT_SEND_DATA 
(INS = '03') 



throwit 

reason = HCI CURRENTLY DISABLED 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



4-EVT_SEND_DATA 
(INS = '04') 



throwit 

reason = HCI FRAGMENTED MESSAGE ONGOING 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



5 - EVT_SEND_DATA 
(INS = '05') 



throwit 

reason = HCI INVALID LENGTH 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



6 - EVT_SEND_DATA 
(INS = '06') 



throwit 

reason = 

HCI LISTENER ALREADY REGISTERED 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



7-EVT_SEND_DATA 
(INS = '07') 



throwit 

reason = HCI NOT AVAILABLE 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



8 - EVT_SEND_DATA 
(INS = '08') 



throwit 

reason = HCI RESOURCES NOT AVAILABLE 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



9 - EVT_SEND_DATA 
(INS = '09') 



throwit 

reason = HCI SERVICE NOT AVAILABLE 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 
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Test Case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 




10-EVT SEND DATA 
(INS = 'OA') 


throwit 

reason = HCI_WRONG_EVENT_TYPE 


Throw exception 
with 

corresponding 
reason code 


EVT SEND DA 
TA (SW - '90 00') 


N1 


11 -EVT SEND DATA 
(INS = 'OB') 


throwit 

reason = HCI_WRONG_LISTENER_TYPE 


Throw exception 
with 

corresponding 
reason code 


EVT SEND DA 
TA (SW - '90 00') 


N1 



6.1.5 Interface HCIListener 
6.1.5.1 Method onCallback 

Test Area Reference: Api_l_Hln_Ocb. 

6.1 .5.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void onCallback {byte event, HCIMessage message) 



6.1.5.1.1.1 



Normal execution 



• CRRNl: The Contactless Framework shall invoke the method *typeListener . onCallback only with 
events which are defined in this particular listener or HCIListener and only with message objects of this 
listener type. 

• CRRN2: The Applet instance shall activate the events with CardEmulationService.activateEvent before it will 
receive any event notification. 

• CRRN3: The context as defined in the Java Card^^ specification [11], [12] and [13] shall be set to the context 
of the Applet which implements the onCallback() method. The previous context (context of the caller) shall be 
the context of the Contactless Framework. 

• CRRN4: Upon return from the onCallback() method a pending transaction shall be aborted. 

• CRRN5: As stated in TS 102 622 [3], a reset of the underlying data link layer shall be transparent to the 
application layer if the data link layer recovers without any loss of data. 

• CRRN6: The Contactless Framework shall be able to receive one or more HCI messages while waiting for a 
response related to a command originated by the Applet (e.g. processing a request for parameters) especially 
for the EVT_FIELD_OFF case. 

6.1.5.1.1.2 Parameter errors 

• None. 



6.1.5.1.1.3 
• None. 



Context errors 
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6.1.5.1.2 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 HIn Ocb 4.java 


1 


Api 1 HIn Ocb S.java 


2 


Api 1 HIn Ocb e.java 


3 


Api 1 HIn Ocb 2.java 


4 


Api 1 HIn Ocb S.java 


5 



6.1.5.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 



6.1.5.1.4 



Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


1 


Get context 


1 - Send 


Service = CardEmulationService 


No exception shall be 


EVT SEND DATA (SW 


N3 




EVT SEND DAT 


Listener = 


thrown 


'90 00') 






A (Select applet) 


CardEmulationListener 










Send 


process ( ) : 


expected AID = 








EVT SEND DAT 


JCSystem.getAID ; 


current AID 








A (INS = '01') 
) 










2 - Send 


Service = CardEmulationService 


No exception shall be 


EVT SEND DATA (SW 


N3 




EVT SEND DAT 


Listener = 


thrown 


'90 00') 






A (Select applet) 


CardEmulationListener 
process ( ) : 


previous AID = null 








Send 












EVT SEND DAT 


JCSystem.getPreviousContextAID ( 










A (INS = '02') 


) ; 








2 


Abort transaction 


Send 


Service = CardEmulationService 


No exception shall be 


EVT SEND DATA (SW 


N4 




EVT SEND DAT 


Listener = 


thrown 


'90 00') 






A (Select applet) 


CardEmulationListener 










-Send 


onCallbackO : 


Test array shall not be 








EVT SEND DAT 


JCsystem.beginTransaction ( ) ; 


modifed 








A (INS = '01') 


Set up test array 










-Send 


//no 










ENVELOPE 


JCSystem. commitTransaction! ! 










command on the 












ISO interface 


processToolkit ( ) : 










which will trigger 


check array modification 










EVENT UNREC 












OGNIZED ENVE 












LOPE in the 












applet as 












specified in 












TS 102 241 [6] 










3 


Data link layer recovery 


-Send 


Service = CardEmulationService 


No exception shall be 


- EVT SEND DATA 


N5 




EVT SEND DAT 


Listener = 


thrown 


(SW - '90 00') in the 






A (Select applet) 
-Send 


CardEmulationListener 
activateEvent (EVENT_ON_SEND_DAT 
A) during the installation 




response to selecting 
applet 






EVT SEND DAT 


onCallbackO 




- EVT SEND DATA 






A (INS = '01') 






(0x00, 0x00, 0x00, 0x00, 






- reset the 


prepareAndSendSendDataEvent ( ) 




0x00, 0x0, 0x00, 0x00, 






underlying data 


data = {OxOO, 0x00, 0x00, 




0x00, ...., 0x90, 0x00) 






link layer while 


0x00, 0x00, 0x0, 0x00, 0x00, 










receiving the 


0x0 0, .... , 0x90, 0x0 0} 




No loss of data expected 






reponse 


length = 256B 
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Test case 


ID 


HCI Command 


API Description API Expectation HCI Response 


CRR 


4 


Receive messages while waiting for get parameter 


EVT_SEND_DAT 
A (Select applet) 

EVT FIELD OFF 
before ANY_OK 


Listener = 

CardEmulationListener 
activateEvent ( ) 
event = 
EVENT_GET_PARAMETER_RESPONSE 

prepareAndSendGetParameterComma 

ndO 

paramID = 

PARAM ID TYPE B CARD ATQB 


No exception shall be 
thrown 

onCallbackO shall 
receive ANY OK as 
EVENT GET PARAM 
ETER_RESPONSE 


EVT_SEND_DATA () 

ANY GET PARAMETE 
R(ATOB) 

No error after 
EVT_FIELD_OFF 


N1, 
N2, N6 


5 


Receive messages while waiting for get parameter 


EVT_SEND_DAT 
A (Select applet) 

EVT FIELD OFF 
before ANY_OK 


Listener = 

CardEmulationListener 
activateEvent ( ) 
event = 
EVENT_GET_PARAMETER_RESPONSE 

prepareAndSendGetParameterComma 

ndO 

paramID = 

PARAM ID TYPE A CARD ATQA 


No exception shall be 
thrown 

onCallbackO shall 
receive ANY OK as 
EVENT GET PARAM 
ETER_RESPONSE 


EVT_SEND_DATA () 

ANY GET PARAMETE 
R(ATOA) 

No error after 
EVT_FIELD_OFF 


N1, 
N2, N6 



6.2 Package uicc.hci.services 

6.2.1 Package CardEmulation Service 

6.2.1.1 Interface CardEmulationMessage 

6.2.1 .1 .1 Method prepareAndSendGetParameterCommand 

Test Area Reference: Api_2_CEm_ Sgp. 

6.2.1 .1 .1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendGetParameterCommand {byte paramID) 

throws HCIException 



6.2.1.1.1.1.1 



Normal execution 



CRRNl: this non-blocking method builds the HCI command ANY_GET_PARAMETER for the indicated 
information and sends it to the appropriate Card RF Gate of the CLE. 

CRRN2: the paramID indicates a constant parameter of the requested value. 

CRRN3: The CardEmulationListener.onCallback method shall be called by the Contactless Framework. The 
HCI message that resulted in the selection of this Applet according to the rules defined in "GlobalPlatform 
Amendment C" [10] shall be provided by the CardEmulationMessage. 



6.2.1.1.1.1.2 



Parameter errors 



CRRPl: throws HCIException with the reason code HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 
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6.2.1.1.1.1.3 



Context errors 



CRRCl: throws HCIException with the reason code HCI_FRAGMENTED_MESSAGE_ONGOING if the 
Contactless Framework is still receiving a fragmented HCI Message. 

CRRC2: throws HCIException with the reason code HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 



6.2.1.1.1.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CEm Sgp l.java 


1-1 


Api 2 CEm Sgp 2.java 


1-2 


Api 2 CEm Sgp S.java 


1-S 


Api 2 CEm Sgp 4.java 


1-4 


Api 2 CEm Sgp S.java 


1-S 


Api 2 CEm Sgp 6.java 


1-6 


Api 2 CEm Sgp 7.java 


1-7 


Api 2 CEm Sgp S.java 


1-8 


Api 2 CEm Sgp 9.java 


2-1 


Api 2 CEm Sgp lO.java 


2-2 


Api 2 CEm Sgp 11. Java 


2-S 


Api 2 CEm Sgp 12.java 


2-4 


Api 2 CEm Sgp 1 S.java 


2-S 


Api 2 CEm Sgp 14.java 


S-1 


Api 2 CEm Sgp 1 S.java 


S-2 



6.2.1.1.1.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 



6.2.1.1.1.4 



Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response 



CRR 



Get parameter: Type A 



1 - 

EVT_SEND_DAT 
A (Sele 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM_ID_TYPE_A_CARD_APPLICATION_D 
ATA 



No exception shall be 
thrown 



GET_PARAMETER 
with command 
parameter as indicated 
in the API Description 
column 



N1, 
N2, NS 



2- 

EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM_I D_T Y P E_A_C ARD_ATQA 



No exception shall be 
thrown 



GET_PARAMETER 
with command 
parameter as indicated 
in the API Description 
column 



N1, 
N2, NS 



S- 

EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM ID TYPE A CARD CID SUPPORT 



No exception shall be 
thrown 



GET_PARAMETER 
with command 
parameter as indicated 
in the API Description 
column 



N1, 
N2, NS 



4- 

EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM ID TYPE A CARD CLT SUPPORT 



No exception shall be 
thrown 



GET_PARAMETER 
with command 
parameter as indicated 
in the API Description 
column 



N1, 
N2, NS 



EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM ID TYPE A CARD DATARATE MAX 



No exception shall be 
thrown 



GET_PARAMETER 
with command 
parameter as indicated 
in the API Description 
column 



N1, 
N2, NS 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 




6- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET PARAMETER 


N1, 




EVT SEND DAT 


) 


thrown 


with command 


N2, N3 




A (Select applet) 


paramID = 
PARAM_ID_TYPE_A_CARD_FWI_SFGI 




parameter as indicated 
in the API Description 
column 




7- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET PARAMETER 


N1, 




EVT SEND DAT 


) 


thrown 


with command 


N2, N3 




A (Select applet) 


paramID = 

P ARAM_I D_T Y P E_A_C ARD_MOD E 




parameter as indicated 
in the API Description 
column 




8- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET PARAMETER 


N1, 




EVT SEND DAT 


) 


thrown 


with command 


N2, N3 




A (Select applet) 


paramID = PARAM_ID_TYPE_A_CARD_SAK 




parameter as indicated 
in the API Description 
column 




2 


Get parameter: Type B 


1- 




No exception shall be 


GET PARAMETER 


N1, 




EVT SEND DAT 


prepareAndSendGetParameterCommand { 


thrown 


with command 


N2, N3 




A (Select applet) 


) 

paramID = 

PARAM_I D_TYPE_B_CARD_AF I 




parameter as indicated 
in the API Description 
column 




2- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET PARAMETER 


N1, 




EVT SEND DAT 


) 


thrown 


with command 


N2, N3 




A (Select applet) 


paramID = 

PARAM_I D_TYPE_B_CARD_ATQB 




parameter as indicated 
in the API Description 
column 




3- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET PARAMETER 


N1, 




EVT SEND DAT 


) 


thrown 


with command 


N2, N3 




A (Select applet) 


paramID = 
PARAM_ID_TYPE_B_CARD_DATARATE_MAX 




parameter as indicated 
in the API Description 
column 




4- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET PARAMETER 


N1, 




EVT SEND DAT 


) 


thrown 


with command 


N2, N3 




A (Select applet) 


paramID = 

PARANOID TYPE B CARD HIGHER LAYER 

RESPONSE 




parameter as indicated 
in the API Description 
column 




5- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET PARAMETER 


N1, 




EVT SEND DAT 


) 


thrown 


with command 


N2, N3 




A (Select applet) 


paramID = 

PARAM_I D_T Y P E_B_C ARD_MOD E 




parameter as indicated 
in the API Description 
column 




3 


The Contactless Framework is receiving fragmented HCI Message 




1 - 


prepareAndSendGetParameterCommand { 
) 


Shall throw 

uicc.hci. framework. HCIE 


- EVT SEND DATA 
(SW - '90 00') 


C1 




EVT_SEND_DAT 
A (Select applet) 


paramID = 
PARAM_ID_TYPE_A_CARD_ATQA 


xception with error code 
HCI FRAGMENTED M 
ESSAGE_ONGOING 


- EVT SEND DATA 
(No data) 

- EVT_SEND_DATA 
(one byte with second 
least significant bit set) 






Send as 












fragmented HCI 












Message: 












EVT SEND DAT 












A (data length = 












supported buffer 












size + 5 bytes, 












message not 












complete) 












With CB = 1 for 












the last sent 












frame 












EVT SEND DAT 












A sent without 












waiting for 












response 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 




2 


prepareAndSendGetParameterCommand { 


Shall throw 


- EVT SEND DATA 


C1 




EVT_SEND_DAT 


) 


uicc.hci. framework. HCIE 


(SW - '90 00') 






A (Select applet) 


paramID = 

PARAM_I D_T Y P E_B_C ARD_ATQB 


xception with error code 
HCI FRAGMENTED M 
ESSAGE_ONGOING 


- EVT SEND DATA 
(No data) 

- EVT_SEND_DATA 
(one byte with second 






Send as 






least significant bit set) 






fragmented HCI 












Message: 












EVT_SEND_DAT 












A (data length = 












supported buffer 












size + 5 bytes, 












message not 












complete) 












EVT_SEND_DAT 












A sent without 












waiting for 












response 











6.2.1 .1 .2 Method prepareAndSendSendDataEvent 

Test Area Reference: Api_2_CEm_ Ssd. 

6.2.1 .1 .2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendSendDataEvent {byte [] data, 

short offset, 

short len) 

throws HCIException, 

Java. lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException 



6.2.1.1.2.1.1 



Normal execution 



• CRRN 1 : This non-blocking method builds the the HCI event EVT_SEND_DATA sends it to the Contactless 
Card Emulation Gate of the CLE. 

• CRRN2: the data to be sent should be formatted according to the HCI specification, the offset define the offset 
of data into the data buffer and the len define the length of data in the data buffer. 

• CRRN3: Applet instances shall receive CardEmulationMessages after the registration of a 
CardEmulationListener interface to a CardEmulationService only if the EVENT_ON_SEND_DATA is 
activated for the Applet instance. 

• CRRN4: The CardEmulationListener.onCallback method shall be called by the Contactless Framework. The 
HCI message that resulted in the selection of this Applet according to the rules defined in "GlobalPlatform 
Amendment C" [10] shall be provided by the CardEmulationMessage. 

6.2.1.1.2.1.2 Parameter errors 

• CRRPl: throws java.lang.NullPointerException - if data is null. 

• CRRP2: throws java.lang.ArraylndexOutOfBoundsException - if operation would cause access of data outside 
array bounds. 
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6.2.1.1.2.1.3 



Context errors 



CRRCl: throws HCIException with the reason code HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

CRRC2: throws HCIException with the reason code HCI_FRAGMENTED_MESSAGE_ONGOING if the 
Contactless Framework is still receiving a fragmented HCI Message. 

CRRC3: throws HCIException with the reason code HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 



6.2.1.1.2.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CEm Ssd Ljava 


1 


Api 2 CEm Ssd Ljava 


2 


Api 2 CEm Ssd Ljava 


3 


Api 2 CEm Ssd 4.java 


4 


Api 2 CEm Ssd 2.java 


5-1 


Api 2 CEm Ssd S.java 


5-2 



6.2.1.1.2.3 Initial conditions 

All test cases shall be executed in both full power mode and low power mode. 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT CARD ACTIVATED has been sent on HCI interface. 



6.2.1.1.2.4 



Test procedure 



Test case 


ID 


HCI Commnad 


API Description API Expectation 


HCI Response 


CRR 


1 


Send data - Type A 


EVT SEND DATA 


prepareAndSendSendDataEvent ( 


No exception shall 


EVT SEND DATA 


NL 




(Select applet) 


) 


be thrown 


({0x03, 0x04, 0x05, 


N2, 






data = {OxOl, 0x02, 0x03, 




0x06, 0x07}) 


N3, N4 






0x04, 0x05, 0x06, 0x07, 












0x08, 0x09} 












offset = 2 












length = 5 








2 


Send data - Type B 


EVT SEND DATA 


prepareAndSendSendDataEvent ( 


No exception shall 


EVT SEND DATA 


NL 




(Select applet) 


) 


be thrown 


({0x03, 0x04, 0x05, 


N2, 






data = {OxOl, 0x02, 0x03, 




0x06, 0x07}) 


N3, N4 






0x04, 0x05, 0x06, 0x07, 












0x08, 0x09} 












offset = 2 












length = 5 








3 


Recption of fragmented HCI Message 


- EVT SEND DATA 


prepareAndSendSendDataEvent ( 


Shall throw 


- EVT SEND DATA 


C2 




to select applet 


) 


uicc.hci.framework.H 


(SW - '90 00') 






Send as fragmented 
HCI Message: 


data = {OxOl, 0x02, 0x03, 
0x04, 0x05, 0x06, 0x07, 
0x08 0x09} 


CI Exception with 
error code 


- EVT SEND DATA 
(No data) 






- EVT SEND DATA 


offset - 2 


HCI FRAGMENTED 








(data length = 


length = 5 


MESSAGE ONGOI 


- EVT SEND DATA 






supported buffer size 




NG 


(SW- '90 02') 






+ 5 bytes, message 












not complete) 












- EVT SEND DATA 












(INS = '01') without 












waiting for response 












-Send 












EVT SEND DATA 












(INS = '01') 
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Test case 



ID 



HCI Commnad 



API Description 



API Expectation 



HCI Response 



CRR 



Send no data 



EVT_SEND_DATA 
(Select applet) 



prepareAndSendSendDataEvent ( 
) 



data = null 
offset = 2 
length = 5 



Shall throw java.lang 
exception with error 
code 
NullPointerException 



EVT_SEND_DATA 
({OxFF, OxFF, OxFF, 
OxFF, OxFF }) 



P1 



Array Index Out Of Bounds 



1 - 

EVT_SEND_DATA 
(Select applet) 



prepareAndSendSendDataEvent ( 
) 

1 - data = {OxOl, 0x02, 

0x03, 0x04, 0x05, 0x06, 

0x07, 0x08, 0x09} 

offset = 2 

length = 15 



Shall throw java.lang 
exception with error 
code 

ArraylndexOutOfBou 
ndsException 



EVT_SEND_DATA 
({OxFF, OxFF, OxFF, 
OxFF, OxFF }) 



P2 



EVT_SEND_DATA 
(Select applet) 



prepareAndSendSendDataEvent ( 
) 



data = 


{OxOl 


, 0x02 


, 0x03 


0x04, 


x05. 


0x06, 


0x07, 


0x08, 


x09} 






offset 


= 15 






length 


= 5 







Shall throw java.lang 
exception with error 
code 

ArraylndexOutOfBou 
ndsException 



EVT_SEND_DATA 
({OxFF, OxFF, OxFF, 
OxFF, OxFF }) 



P2 



6.2.1 .1 .3 Method selectingMessage 

Test Area Reference: Api_2_CEm_ Scm 

6.2.1 .1 .3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

boolean selectingMessage { ) 



6.2.1.1.3.1.1 



Normal execution 



• CRRNl: This method is used by the applet to distinguish the HCI Message command which selected this 
applet from all other HCI messages. 

• CRRN2: returns true if the current HCI message caused the selection of the Applet according to the rules in 
GlobalPlatform Amendment C [10]. 



6.2.1.1.3.1.2 
• None. 



Parameter errors 



6.2.1.1.3.1.3 
• None. 



Context errors 



6.2.1.1.3.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CEm Scm l.java 


1 


Api_2_CEm_Scm_1 .Java 


2 



6.2.1.1.3.3 Initial conditions 

All test cases shall be executed in both full power mode and low power mode. 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 
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6.2.1.1.3.4 



Test procedure 



Test case 


ID 


HCI Command API Description API Expectation HCI Response CRR 


1 


Select Applet 


EVT_SEND_DATA 
(Select applet) 


selectingMessage { ) 


No exception shall be 
thrown. 

selectingMessage()= 
true 


EVT SEND DATA (SW - 
'90 00') 


N1, 
N2 


2 


Arbitrary Command 


- EVT_SEND_DATA 
(Select applet) 
- EVT SEND DATA (INS 
= ■01') 


selectingMessage { ) 


No exception shall be 
thrown. 

selectinglVlessageO = 
false 


- EVT SEND DATA(SW - 
'90 00') 

- EVT SEND DATA ('01 
02 03 90 00') 


N1, 
N2 



6.2.1.2 



Interface CardEmulationService 



6.2.1 .2.1 Method getCardRFType 

Test Area Reference: Api_2_CEs_RFt. 

6.2.1 .2.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

byte getCardRFType { ) 

6.2.1 .2.2.1 .1 Normal execution 

• CRRNl : returns the reader RF type on which the service is connected, shall be one of the TYPE_* constant 
values defined in this interface, or -1 if the RF type can not be evaluated. 

• CRRN2: Applets communicating through the process() method shall also be able to use the API services 
defined in the present document which do not require a CardEmulationListener registration (e.g. requesting the 
power mode or connectivity service). 



6.2.1.2.2.1.2 
• None. 



Parameter errors 



6.2.1.2.2.1.3 
• None. 



Context errors 



6.2.1.2.2 



Test Suite Files 



Applet Name 


Test case ID 


Api 2 CEs RFt Ljava 


1 


Api 2 CEs RFt Ljava 


2 


Api 2 CEs RFt Ljava 


3 


Api 2 CEs RFt Ljava 


4 
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6.2.1.2.3 Initial conditions 

All test cases shall be executed in both full power mode and low power mode. 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.2.1.2.3.1 Test procedure 



Test case 


ID 


HCI Command API Description 


API Expectation 


HCI Response |CRR 


1 


RF type A 


EVT SEND DATA 
(INS = '01') 


getCardRFType { ) 


No exception shall be thrown 
getCardRFTypeO = TYPE A CARD RF 


EVT SEND DATA 
(SW = '90 01') 


N1 
N2 


2 


RF type B 


EVT SEND DATA 
(INS = '01') 


getCardRFType { ) 


No exception shall be thrown 
getCardRFTypeO = TYPE B CARD RF 


EVT SEND DATA 
(SW = '90 02') 


N1 
N2 


3 


RF type F 


EVT SEND DATA 
(INS = '01') 


getCardRFType { ) 


No exception shall be thrown 
getCardRFTypeO = TYPE F CARD RF 


EVT SEND DATA 
(SW = '90 04') 


N1 
N2 


4 


RF type B' 


EVT SEND DATA 
(INS = '01') 


getCardRFType { ) 


No exception shall be thrown 
getCardRFTypeO = TYPE B PRIM CARD RF 


EVT SEND DATA 
(SW = '90 03') 


N1 
N2 



6.2.1.3 



Interface CardEmuiationLlstener 



6.2.1.3.1 Method onCallback 

Test Area Reference: Api_2_CEl_Ocb. 

6.2.1 .3.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void onCallback {byte event, HCIMessage message) 



6.2.1.3.1.1.1 



Normal execution 



CRRNl: The Contactless Framework shall invoke the method CardEmulationListener.onCallback only with 
events which are defined in this particular listener or CardEmuiationLlstener and only with 
CardEmulationMessage objects. 

CRRN2: The Applet instance shall activate the events with CardEmulationService.activateEvent before it will 
receive any event notification. 

CRRN3: If the EVENT_ON_SEND_DATA is deactivated for the Applet instance the 

javacard. frame work. APDU class and the process() method shall be used if the current application protocol is 
APDU based. Otherwise, if the EVENT_ON_SEND_DATA is deactivated and the current application 
protocol is not APDU based the process() method will not be invoked, i.e. the Applet will not receive any 
messages from the external reader. 

CRRN4: It shall not be possible to switch between the usage of the CardEmuiationLlstener interface and the 
invocation through the process() method within a contactless application session, i.e. not before the Applet has 
been deselected and selected again. 



6.2.1.3.1.1.2 
• None. 



Parameter errors 
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Context errors 



Test Suite Files 



Applet Name 


Test case ID 


Api 2 CEI Ocb l.java 


1 


Api 2 CEI Ocb 2.java 


2 


Api 2 CEI Ocb 4.java 


3 


Api 2 CEI Ocb l.java 


4 


Api 2 CEI Ocb 2.java 


5 


Api 2 CEI Ocb S.java 


6 


Api 2 CEI Ocb S.java 


7-1 


Api 2 CEI Ocb e.java 


7-2 


Api 2 CEI Ocb y.java 


7-3 


Api 2 CEI Ocb S.java 


7-4 



6.2.1.3.1.3 Initial conditions 

All test cases shall be executed in both full power mode and low power mode. 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.2.1.3.1.4 Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


1 


EVT SEND DATA - Type A 


EVT SEND DAT 
A(INS = '14') 

EVT SEND DAT 
A(INS = '24')- 

- deselect the 
applet 

- select the applet 


HCIListener = 

CardEmulationListener 

HCIService = 

CardEmulationService 

activateEvent ( ) 

event = 

CardEmulationListener .EVENT ON 

SEND_DATA 


- No exception shall be 
thrown 

- No exception shall be 
thrown 

onCallbackO method 
shall notice the event 
EVENT ON SEND D 
ATA 


- EVT SEND DATA 
(SW- '90 00') 

- EVT SEND DATA 
(SW- '90 00') 

- No response or no 
data in the response to 
the select applet 
command 


N1, 
N2, 
N3, 
N4, 
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Test case 


ID HCI Command 


API Description API Expectation 


HCI Response 


CRR 


EVENT_HCI RECEPTIONS_FAILED - Type A 


2 


- 


HCIListener = 


No exception shall be 


-EVT SEND DATA 


N1, 




EVT SEND DAT 


CardEmulationListener 


thrown 


(SW- '90 00') 


N2, 




A(INS = '11') 


HCIService = 




- EVT SEND DATA 


N3, 






CardEmulationService 


onCallbackO method 


(SW- '90 00') 


N4 




EVT SEND DAT 


activateEvent ( ) 


shall notice the event 


- EVT SEND DATA 






A(INS = '14') 


event = 

HCIListener . EVENT_HCI_RECEPTION 




(SW- '90 00') 






- deselect/select 


S_FAILED 




- Response to RF error 






the applet 






message not verified 






_ 






- EVT SEND DATA 






EVT SEND DAT 






(SW- '90 00') 






A(INS = '11', RF 












error indicator is 












set to '01') 






- EVT SEND DATA 
(SW- '90 00') 






- deselect/select 












the applet 












EVT SEND DAT 












A(INS = '21') 










3 




EVENT GET PARAMETER RESPONSE - Type 


A 




- 


Listener = 


No exception shall be 




N1, 




EVT SEND DAT 


CardEmulationListener 


thrown 


GET PARAMETER with 


N2, 




A (INS = '01') 
- ANY_OK as 


activateEvent ( ) 

event = 

EVENT_GET_PARAMETER_RESPONSE 


onCallbackO shall 


the 

PARAM ID TYPE A C 


N3, 
N4, 




response to 




receive ANY OK as 


ARD_ATQA 






GET PARAMET 


prepareAndSendGetParameterComma 


EVENT GET PARAM 


- No exception after 






ER 


ndO 
paramID = 


ETER_RESPONSE 


ANY_OK reception 






- deselect/select 


PARAM_ID_TYPE_A_CARD_ATQA 




- EVT SEND DATA 






the applet 






(SW- '90 00') 






EVT SEND DAT 






- EVT SEND DATA 






A(INS='22') 






(SW- '90 00') 




4 


EVT_SEND_DATA - Type B 


- 


HCIListener = 


- No exception shall be 


- EVT SEND DATA 


N1, 




EVT SEND DAT 


CardEmulationListener 


thrown 


(SW- '90 00') 


N2, 




A(INS = '14') 


HCIService = 






N3, 






CardEmulationService 
activateEvent ( ) 


- No exception shall be 


- EVT SEND DATA 


N4, 




EVT SEND DAT 


event = 


thrown 


(SW- '90 00') 






A(INS = '24')- 


CardEmulationListener . EVENT_ON_ 












SEND_DATA 


onCallbackO method 


- No response or no 






- deselect the 




shall notice the event 


data in the response to 






applet 




EVENT ON SEND D 


the select applet 






- select the applet 




ATA 


command 
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Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


5 


EVENT_HCLRECEPTIONS_FAILED - Type B 


- 


HCIListener = 


No exception shall be 


-EVT SEND DATA 


N1, 




EVT SEND DAT 


CardEmulationListener 


thrown 


(SW- '90 00') 


N2, 




A(INS = '11') 


HCIService = 




- EVT SEND DATA 


N3, 






CardEmulationService 


onCallbackO method 


(SW- '90 00') 


N4 




EVT SEND DAT 


activateEvent ( ) 


shall notice the event 


- EVT SEND DATA 






A(INS = '14') 


event = 

HCIListener . EVENT_HCI_RECEPTION 




(SW- '90 00') 






- deselect/select 


S_FAILED 




- Response to RF error 






the applet 






message not verified 






_ 






- EVT SEND DATA 






EVT SEND DAT 






(SW- '90 00') 






A(INS = '11', RF 












error indicator is 












set to '01') 






- EVT SEND DATA 
(SW- '90 00') 






- deselect/select 












the applet 












EVT SEND DAT 












A(INS = '21') 










6 




EVENT_GET_PARAMETER_RESPONSE - Type 


B 




- 


Listener = 


No exception shall be 


- GET_PARAMETER 


N1, 




EVT SEND DAT 


CardEmulationListener 


thrown. 


with the 


N2, 




A (INS = '01') 
- ANY_OK as 


activateEvent ( ) 

event = 

EVENT_GET_PARAMETER_RESPONSE 


onCallbackO shall 


PARAM ID TYPE B 
ARD_ATQB 


N3, 
N4 




response to 




receive ANY OK as 


- No exception after 






GET PARAMET 


prepareAndSendGetParameterComma 


EVENT GET PARAM 


ANY OK reception 






ER 


ndO 


ETER_RESPONSE 


- EVT SEND DATA 






- deselect/select 


paramID = 




(SW- '90 00') 






the applet 


PARAM_ID_TYPE_B_CARD_ATQB 










_ 






- EVT SEND DATA 






EVT SEND DAT 






(SW- '90 00') 






A(INS = '22') 










7 


Deactivate events 


1 - 


HCIService = 


No exception shall be 


EVT SEND DATA (SW- 


N2 




EVT SEND DAT 


CardEmulationService 


thrown. 


'90 00') 






A(INS='11') 


Event has been successfully 
activated 


onCallbackO method 


- EVT SEND DATA 






- deselect/select 


deactivateEvent ( ) 


shall not notice the 


(SW- '90 00') 






the applet 


event = 


event 








- 


HCIListener . EVENT_HCI_RECEPTION 




- Response to RF error 






EVT SEND DAT 


S_FAILED 




message not verified 






A(INS='20', RF 












error indicator is 






- EVT SEND DATA 






set to '01') 






(SW- '90 00') 






- deselect/select 






- EVT SEND DATA 






the applet 






(SW- '90 00') 






EVT SEND DAT 












A(INS='20') 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 




2- 


HCIService = 


No exception shall be 


- ignore the first 


N2 




EVT SEND DAT 


CardEmulationService 


thrown 


response 






A(INS='12') 


Event has been successfully 
activated 


onCallbackO method 


- EVT SEND DATA 






- ANY_OK as 


deactivateEvent ( ) 


shall not notice the 


(SW- '90 00') 






response to 


event = 


event 








GET PARAMET 


CardEmulationListener .EVENT GET 




- EVT SEND DATA 






ER 


_PARAMETER_RESPONSE 




(SW- '90 00') 






- deselect/select 


prepareAndSendGetParameterComma 










the applet 


nd() 
paramID = 












PARAM_ID_TYPE_A_CARD_ATQA 










EVT SEND DAT 












A(INS='20') 










3- 


HCIService = 


No exception shall be 


- ignore the first 


N2 




EVT SEND DAT 


CardEmulationService 


thrown 


response 






A(INS='12') 


Event has been successfully 
activated 


onCailbackO method 


- EVT SEND DATA 






- ANY_OK as 


deactivateEvent ( ) 


shall not notice the 


(SW- '90 00') 






response to 


event = 


event 








GET PARAMET 


CardEmulationListener . EVENT_GET 




- EVT SEND DATA 






ER 


_PARAMETER_RESPONSE 




(SW- '90 00') 






- deselect/select 


prepareAndSendGetParameterComma 










the applet 


nd ( ) 
paramID = 












PARAM_ID_TYPE_B_CARD_ATQB 










EVT SEND DAT 












A(INS='20') 










4- 


HCIService = 


No exception shall be 


- EVT SEND DATA 


N2 




- 


CardEmulationService 


thrown 


(SW- '90 00') 






EVT SEND DAT 


Event has been successfully 




- EVT SEND DATA 






A(INS='14') 


activated 


onCallbackO method 


(SW- '90 00') 






- deselect 


deactivateEvent () 


shall not notice the 


- EVT SEND DATA 






/select the applet 


event = 


event 


(SW-'90 01') 






- 


CardEmulationListener .EVENT ON 










EVT SEND DAT 


SEND DATA 










A(INS='20') 











6.2.2 Package Connectivity Service 
6.2.2.1 Interface ConnectivityService 

6.2.2.1.1 Method prepareAndSendConnectivityEvent 

Test Area Reference: Api_2_CNs_Sce. 

6.2.2.1 .1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendConnectivityEvent {) 

throws HCIException 



6.2.2.1.1.1.1 



Normal execution 



CRRNl: This non-blocking method builds the HCI event EVT_CONNECTIVITY which notifies the terminal 
host that it shall send a "HCI connectivity event" as defined in TS 102 223 [7]. 
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CRRN2: If the Applet wants to use proactive functionality it shall use the Connectivity Service defined above 
to send an HCI event EVT_CONNECTIVITY to the terminal, register for 

EVENT_EVENT_DOWNLOAD_HCI_CONNECTIVITY and return. All the proactive functionality of the 
UICC API defined in TS 102 241 [6] is then available to the Applet when that Applet instance is triggered 
with the processToolkitO method defined in TS 102 241 [6]. 

CRRN3: the contactless runtime environment shall bind the services defined in uicc.hci. services. connectivity 
to the corresponding resources (e.g. gates and pipes) specified by the HCI protocol [3] for the connectivity 
service. 

CRRN4: The Contactless Framework shall only send the HCI event EVT_CONNECTIVITY or 
EVT_TRANSACTION specified by the HCI protocol [3] to an Applet instance, when it is the selected Applet, 
which is in card emulation mode or when it is in the state ACTIVATED (according to "GlobalPlatform 
Amendment C" [10]) for the reader mode. 

CRRN5: The ProactiveHandler defined in TS 102 241 [6] shall not be available when the contactless Applet is 
invoked with the callback methods defined in the present document, or when the Applet is invoked with the 
processO method of the Applet class defined in Application Programming Interface, Java Card'^ Platform [6] 
(in card emulation mode). 



6.2.2.1.1.1.2 
• None. 



Parameter errors 



6.2.2.1.1.1.3 



Context errors 



CRRCl: throw HCIException with error code reason HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

CRRC3: throw HCIException with error code reason HCI_CONDITIONS_NOT_SATISFIED if the 
conditions to call this method are not satisfied. 



6.2.2.1.1.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CNs See Ljava 


1 


Api 2 CNs See Ljava 


2-1 


Api 2 CNs See 6.java 


2-2 


Api 2 CNs See 2.java 


3 


Api 2 CNs See S.java 


4 


Api 2 CNs See 4.java 


5 


Api 2 CNs See S.java 


6 



6.2.2.1.1.3 



Initial condition 



Prior to this test the Terminal shall have been powered on and performed the PROFILE DOWNLOAD 
procedure. 

In terminal profile set the 25th byte, 'b6' indicates that class m is supported. 

In terminal profile 5th byte, bl indicates proactive UICC: SET UP EVENT LIST. 

UICC has created and opened a pipe to connectivity gate in the terminal host 

EVT_FIELD_ON has been sent on HCI interface. 

EVT_CARD_ACTIVATED has been sent on HCI interface. 

According applet has been successfully installed and selected using HCI interface. 
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6.2.2.1.1.4 



Test procedure 



Test case 


ID 


HCI commands 


API Description API Expectation 


HCI Response 


CRR 


1 


Send HCI Connectivity Event 


-Send 


Listener = CardEmulationListener 


No exception shall be 


EVT SEND DA 


N1 




EVT SEND DATA 


process { ) : 


thrown 


TA (SW - '90 


N3 




(INS = '01') 


prepareAndSendConnectivityEvent { ) 




00') 

HCI event 

EVT CONNECT 

IVITY sent 




2 


HCI Interface disabled 


1 - Precondition: 


Listener = CardEmulationListener 


throw HCIException 


SW - '90 00' 


CI 




Contactless 


process { ) : 


with error code 


No EVT 


N3 




functionality state is 


prepareAndSendConnectivityEvent { ) 


reason 


CONNECTIVITY 






disabled in the UICC 




HCI CURRENTLY D 


shall be sent 






as defined in 




ISABLED 








TS 102 223 [7]. 












Send on ISO 












interface: 












- Select applet 












-SendAPDU (INS = 












'02') 










2 - Precondition: 


setCommunicationlnterf ace { ) API 


throw HCIException 


SW - '90 00' 


CI 




Contactless 


method of Global Platform 


with error code 


No EVT 


N3 




functionality state is 
disabled in the UICC 


Amendment C [10] is used to disable 
HCI interface in the CRS 


reason 

HCI CURRENTLY D 


CONNECTIVITY 
shall be sent 






as defined in Global 


Listener = CardEmulationListener 


ISABLED 








Platform Amendment 


process { ) : 










C Send on ISO 


prepareAndSendConnectivityEvent { ) 










interface send the 












following commands: 


setCommunicationlnterf ace { ) API 










- Send APDU to 


method of Global Platform 
Amendment C [10] is used to enable 










select the applet. 


again HCI interface 










-SendAPDU (INS = 












'02') 












- Postcondition: 












Contactless 












functionality state is 












enabled again in the 












UICC as defined in 












Global Platform 












Amendment C 










3 


Wrong Precondition Connectivity Event 


Send on ISO: 


Service = ConnectivityService 


Shall throw exception 


No EVT 


N4, 




- Select applet 


Listener = ConnectivityListener 


with error code 


CONNECTIVITY 


C3 




-Send 


process { ) 
ConnectivityService . 


reason 


shall be sent 






APDU with (INS = 


HCI CONDITIONS 








'01') 


prepareAndSendConnectivityEvent { ) 


NOT_SATISFIED 






4 


No Proactive Handler 


-Send 


Service = CardEmulationService 


ProactiveHandler 


EVT SEND DA 


N5 




EVT SEND DATA 


Listener = CardEmulationListener 


shall not be available 


TA (SW - '90 






(INS = '01') 


process { ) 

ProactiveHandlerSystem.getTheHandle 

r{) 




00') 




5 


No Proactive Handler onCallback 


-Send 


Service = CardEmulationService 


ProactiveHandler 


EVT SEND DA 


N5 




EVT SEND DATA 


Listener = CardEmulationListener 


shall not be available 


TA (SW - '90 






(INS = '01') 


activateEvent {EVENT_ON_SEND_DATA) 




00') 






during the installation 










onCallbaclcO 












ProactiveHandlerSystem.getTheHandle 












r{) 









£75/ 



Release 9 



67 



ETSI TS 103 115 V9.1.0 (2013-07) 



Test case 


ID 


HCI commands 


API Description API Expectation 


HCI Response 


GRR 


6 


Use proactive functionality 


-Send 


Listener = CardEmulationListener 


No exception shall be 


- 


N1 




EVT SEND DATA 
with INS = '01' 
- Send ENVELOPE 
(HCI Connectivity) 
on ISO interface 


process { ) : 

prepareAndSendConnectivityEvent { ) 
register for 

EVENT_EVENT_DOWNLOAD_HCI_CONNECTIVI 
TY 


thrown 


EVT SEND DA 
TA (SW - '90 
00') 

- HCI event 


N2N3 




after receiving HCI 


processToolkit { ) : 




EVT CONNECT 






Connectivity Event 


use arbitrary method of the UICC 
API {TS 102 241 [6] ) 




IVITY sent 

- response to 
ENVELOPE 





6.2.2.1 .2 Method prepareAndSendTransactionEvent(byte[] aid, short aidOffset, 

short aidLen, byte[] parameters, short parametersOffset, short parametersLen) 

Test Area Reference: Api_2_CNs_Ste. 



6.2.2.1.2.1 



Conformance requirements 



The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendTransactionEvent {byte [] aid, 

short aidOffset, 

short aidLen, 

byte[] parameters, 

short parametersOffset, 

short parametersLen) 

throws HCIException 

j ava . lang . ArraylndexOutOf BoundsException, 
Java . lang.NullPointerException 



6.2.2.1.2.1.1 



Normal execution 



• CRRNl : this non-blocking method builds the HCI event EVT_TRANS ACTION which notifies the terminal 
host that it shall launch an application on the terminal which is associated to an Applet in the UICC host 
identified. 

• CRRN2: the contactless runtime environment shall bind the services defined in uicc.hci. services. connectivity 
to the corresponding resources (e.g. gates and pipes) specified by the HCI protocol [3] for the connectivity 

service. 

• CRRN3: The Contactless Framework shall only send the HCI event EVT_CONNECTIVITY or 
EVT_TRANSACTION specified by the HCI protocol [3] to an Applet instance, when it is the selected Applet, 
which is in card emulation mode or when it is in the state ACTIVATED (according to "GlobalPlatform 
Amendment C" [10]) for the reader mode. 



6.2.2.1.2.1.2 



Parameter errors 



CRRPl: throw HCIException with error code reason HCI_INVALID_LENGTH if the parameter length or the 
AID is not compliant to TS 102 622 [3]. 

CRRP2: throw java.lang.ArraylndexOutOfBoundsException - if operation would cause access of data outside 
array bounds. 

CRRP3: throw java.lang.NuUPointerException - if parameters is null. 
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6.2.2.1.2.1.3 



Context errors 



CRRCl: throw HCIException with error code reason HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

CRRC3: throw HCIException with error code reason HCI_CONDITIONS_NOT_SATISFIED if the 
conditions to call this method are not satisfied. 



6.2.2.1.2.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CNs Ste l.java 


1 


Api 2 CNs Ste l.java 


2-1 


Api 2 CNs Ste S.java 


2-2 


Api 2 CNs Ste 4.java 


3 


Api 2 CNs Ste 2.java 


4 


Api 2 CNs Ste S.java 


5 



6.2.2.1.2.3 



Initial condition 



Prior to this test the Terminal shall have been powered on and performed the PROFILE DOWNLOAD 
procedure. 

In terminal profile set the 25th byte, 'b6' indicates that class m is supported. 

In terminal profile 5th byte, bl indicates proactive UICC: SET UP EVENT LIST. 

UICC has created and opened a pipe to connectivity gate in the terminal host 

EVT_FIELD_ON has been sent on HCI interface. 

EVT_CARD_ACTIVATED has been sent on HCI interface. 

According applet has been successfully installed and selected using HCI interface. 

6.2.2.1.2.4 Test procedure 



Test case 


ID 


HCI commands 


API Description API Expectation 


HCI Response CRR 


1 


Send HCI Transaction Event 


Send 


extends CardEmulationListener 


No exception shall be 


EVT SEND DA 


N1, 




EVT SEND DAT 
A with INS = '01' 


process ( ) : 

prepareAndSendTransactionEvent () 
aid = 'A00000000901...01' 
aidOffset = 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


thrown 


TA (SW - '90 00') 

HCI event 
EVT TRANSAC 
TION sent 


N2, 
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Test case 


ID 


HCI commands 


API Description 


API Expectation HCI Response CRR 


2 


HCI interface disabled 


1 - Precondition: 


extends CardEmulationListener 


throw HCI Exception with 


SW - '90 00' 


CI 




Contactless 


process ( ) : 


error code reason 


No 






functionality state 


prepareAndSendTransactionEvent ( ) 


HCI CURRENTLY DISA 


EVT TRANSAC 






is disabled in the 




BLED 


TION shall be 






UICC as defined 






sent 






in TS 102 223 [7]. 












Send on ISO 












interface: 












- Send APDU to 












select the applet 












- Send APDU 












(INS = '02') 










2 - Precondition: 


setCommunicationlnterf ace ( ) API 


throw HCI Exception with 


SW - '90 00' 


CI 




Contactless 


method of Global Platform Amendment 


error code reason 


No 






functionality state 


C [10] is used to disable HCI 
interface 


HCI CURRENTLY DISA 


EVT TRANSAC 






is disabled in the 


BLED 


TION shall be 






UICC as defined 


extends CardEmulationListener 




sent 






in Global 


process ( ) : 










Platform 


prepareAndSendTransactionEvent () 










Amendment C 












Send on ISO 












intprfafp QpnrI 


setCommunicationlnterf ace ( ) API 










11 IICI laLrC7 OCI l\A 

the following 


method of Global Platform Amendment 










C [10] is used to enable again HCI 










commands: 


interface 










- Send APDU to 












select the applet. 












- Send APDU 












(INS = '02') 












- Postcondition: 












Contactless 












functionality state 












is enabled again 












in the UICC as 












defined in Global 












Platform 












Amendment C 










3 


Wrong conditions 


Send on ISO: 


Service = ConnectivityService 


throw HCI Exception with 


SW - '90 00' 


C3 




- Select applet 


Listener = ConnectivityListener 


error code reason 


No EVT 






-Send 


process ( ) : 


HCI CONDITIONS NOT 


TRANSACTION 






APDU with (INS 


prepareAndSendTransactionEvent ( ) 


_SATISFIED 


shall be sent 






= '03') 










4 


Wrong parameters 


1 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.ArraylndexOut 


TA (SW - '90 00') 


P3 




Awith INS = '01' 


prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 20 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


OfBoundsException 


No EVT 

TRANSACTION 
shall be sent 




2 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.ArraylndexOut 


TA (SW - '90 00') 


P3 




Awith INS = '02' 


prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 
aidLen =20 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


OfBoundsException 


No EVT 

TRANSACTION 
shall be sent 
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Test case 


ID 


HCI commands 


API Description 


API Expectation 


HCI Response 


CRR 




3 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.ArraylndexOut 


TA (SW - '90 00') 


P3 




Awith INS = '03' 


prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 20 
parametersLen = 10 


OfBoundsException 


No EVT 

TRANSACTION 
shall be sent 




4 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.ArraylndexOut 


TA (SW - '90 00') 


P3 




Awith INS = '04' 


prepareAndSendTransact ionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 2 


OfBoundsException 


No EVT 

TRANSACTION 
shall be sent 




5 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.NullPointerExc 


TA (SW - '90 00') 


P3 




Awith INS = '05' 


prepareAndSendTransactionEvent ( ) 
aid = null 
aidOffset = 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


eption 


No EVT 

TRANSACTION 
shall be sent 




6- Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.NullPointerExc 


TA (SW - '90 00') 


P3 




AINS = '06' 


prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 
aidLen = 16 
parameters = null 
parametersOf f set = 
parametersLen = 10 


eption 


No EVT 

TRANSACTION 
shall be sent 




5 


Wrong Precondition Transaction Event 


-Send 


Service = ConnectivityService 


Shall throw exception 


EVT SEND DA 


N3 




EVT SEND DAT 


Listener = ConnectivityListener 




TA (SW - '90 00') 






A (INS = '01') 


process ( ) 

ConnectivityService . 
prepareAndSendTransact ionEvent ( ) 




No EVT 

TRANSACTION 
shall be sent 





6.2.2.1 .3 Method prepareAndSendTransactionEvent (byte[] parameters, short 

parametersOffset, short parametersLen) 

Test Area Reference: Api_2_CNs_Stt. 

6.2.2.1.3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendTransactionEvent {byte [] parameters, 

short parametersOffset, 

short parametersLen) 

throws HCIException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Java . lang.NullPointerException 
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6.2.2.1.3.1.1 



Normal execution 



CRRNl: this non-blocking method builds the HCI event EVT_TRANS ACTION which notifies the terminal 
host that it shall launch an application on the terminal which is associated to an Applet in the UICC host 
identified. 

CRRN2: the contactless runtime environment shall bind the services defined in uicc.hci.services.connectivity 
to the corresponding resources (e.g. gates and pipes) specified by the HCI protocol [3] for the connectivity 
service. 



6.2.2.1.3.1.2 



Parameter errors 



• CRRPl : throw HCIException with error code reason HCI_INVALID_LENGTH if the parameter length or the 
AID is not compliant to TS 102 622 [3]. 

• CRRP2: throw java.lang.ArraylndexOutOfBoundsException - if operation would cause access of data outside 
array bounds. 

• CRRP3: throw java.lang.NuUPointerException - if parameters is null. 

6.2.2.1.3.1.3 Context errors 

• CRRCl : throw HCIException with error code reason HCI_CURRENTLY_DIS ABLED if the HCI interface 
was disabled. 

• CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

• CRRC3: throw HCIException with error code reason HCI_CONDITIONS_NOT_SATISFIED if the 
conditions to call this method are not satisfied. 



6.2.2.1.3.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CNs Stt l.java 


1 


Api 2 CNs Stt l.java 


2-1 


Api 2 CNs Stt 4.java 


2-2 


Api 2 CNs Stt S.java 


3 


Api_2_CNs_Stt_2.java 


4 



6.2.2.1.3.3 



Initial condition 



Prior to this test the Terminal shall have been powered on and performed the PROFILE DOWNLOAD 
procedure. 

In terminal profile set the 25th byte, 'b6' indicates that class m is supported. 

In terminal profile 5th byte, bl indicates proactive UICC: SET UP EVENT LIST. 

UICC has created and opened a pipe to connectivity gate in the terminal host 

EVT_FIELD_ON has been sent on HCI interface. 

EVT_CARD_ACTIVATED has been sent on HCI interface. 

According applet has been successfully installed and selected using HCI interface. 
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6.2.2.1.3.4 



Test procedure 



Test case 


ID 


HCI commands 


API Description | API Expectation | HCI Response 


GRR 


1 


Send HCI Transaction Event 


Send 


extends CardEmulationListener 


No exception shall be 


SW - '90 00' 


N1, N2 




EVT SEND DAT 
A with INS = '01' 


process ( ) : 

prepareAndSendTransact ionEvent ( ) 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


thrown 


HCI event 
EVT TRANSAC 
TION sent 




2 


HCI interface disabled 


1 - Precondition: 


extends CardEmulationListener 


throw HCI Exception with 


SW - '90 00' 


C1 




Contactless 
functionality state 


process ( ) : 
prepareAndSendTransact ionEvent ( ) 


error code reason 

HCI CURRENTLY DISA 


No 

EVT TRANSAC 






is disabled in the 




BLED 


TION shall be 






UICC as defined 






sent 






in TS 102 223 [7]. 












Send on ISO 












interface: 












- Send APDU to 












select applet 












- Send APDU 












(INS = '02') 










2 - Precondition: 


setCommunicationlnterf ace ( ) API 


throw HCI Exception with 


SW - '90 00' 


C1 




Contactless 


method of Global Platform Amendment 


error code reason 


No 






functionality state 
is disabled in the 


C [10] is used to disable HCI 
interface 


HCI CURRENTLY DISA 
BLED 


EVT TRANSAC 
TION shall be 






UICC as defined 
in Global 


extends CardEmulationListener 
process ( ) : 




sent 






Platform 


prepareAndSendTransact ionEvent ( ) 










Amendment C 












Send on ISO 


setCommunicationlnterf ace ( ) API 










interface send 
the following 
commands: 


method of Global Platform Amendment 
C [10] is used to enable again HCI 
interface 










- Send APDU to 












select the applet. 












- Send APDU 












(INS = '02') 












- Postcondition: 












Contactless 












functionality state 












is enabled again 












in the UICC as 












defined in Global 












Platform 












Amendment C 










3 


Wrong conditions 


Send on ISO 


Service = ConnectivityService 


throw HCIException with 


SW - '90 00' 


C3 




interface: 


Listener = ConnectivityListener 


error code reason 


No EVT 






- Select applet 

- APDU data with 
INS = '03' 


process ( ) : 
prepareAndSendTransact ionEvent ( ) 


HCI CONDITIONS NOT 
_SATISFIED 


TRANSACTION 
shall be sent 




4 


Wrong parameters 


1 - Send 


extends CardEmulationListener 


throw 


SW - '90 00' 


P2, 




EVT SEND DAT 
A with INS = '01' 


process ( ) : 

prepareAndSendTransact ionEvent () 
parameters = '01...01' 
parametersOf f set = 20 
parametersLen = 10 


java.lang.ArraylndexOut 
OfBoundsException 


No EVT 

TRANSACTION 
shall be sent 


P3 
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Test case 


ID 


HCI commands 


API Description 


API Expectation 


HCI Response 


CRR 




2 - Send 

EVT SEND DAT 

A with INS = '02' 


extends CardEmulationListener 
process ( ) : 

prepareAndSendTransactionEvent () 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 2 


throw 

java.lang.ArraylndexOut 

OfBoundsException 


SW - '90 00' 
No EVT 

TRANSACTION 
shall be sent 


P2, 
P3 


3 - Send 

EVT SEND DAT 

A with INS = '03' 


extends CardEmulationListener 
process ( ) : 

prepareAndSendTransactionEvent ( ) 
parameters = null 
parametersOf f set = 
parametersLen = 10 


throw 

java.lang.NullPointerExc 

option 


SW - '90 00' 
No EVT 

TRANSACTION 
shall be sent 


P2, 
P3 



6.2.3 Package Reader Service 
6.2.3.1 Interface ReaderMessage 

6.2.3.1.1 Method restartReaderModeProcedure 

Test Area Reference: Api_2_RMm_Rrp. 

6.2.3.1.1.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 



void restartReaderModeProcedure { ) 



throws HCIException 



6.2.3.1.1.1.1 



Normal execution 



CRRNl: this method sends first the HCI event EVT_END_OPERATION and then the HCI event 
EVT_READER_REQUESTED. 

CRRN2: this method is intended to recover from the following error states: 

reception of EVT_TARGET_DISCOVERED with a MULTIPLE_TARGET_STATUS . 

reception of RESP_WR_RF_ERROR. 

reception of RESP_AN Y_E_TIMEOUT. 

CRRN3: an Applet shall only be able to activate ReaderListener.EVENT_TARGET_DISCOVERED or to use 
the restartReadermodeProcedure method if it is in lifecycle state ACTIVATED. 



6.2.3.1.1.1.2 
• None. 



Parameter errors 



6.2.3.1.1.1.3 



Context errors 



• CRRCl : throw HCIException with error code reason HCI_CURRENTLY_DIS ABLED if the HCI interface is 
disabled. 

• CRRC2: throw HCIException with error code reason HCI_CONDITIONS_NOT_SATISFIED if the Applet is 
not ACTIVATED. 
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6.2.3.1.1.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 RMm Rrp l.java 


1 


Api 2 RMm Rrp l.java 


2 


Api 2 RIVIm Rrp l.java 


3 


Api 2 RIVIm Rrp 2.java 


4 


Api 2 RMm Rrp 2.java 


5-1 


Api 2 RMm Rrp S.java 


5-2 



6.2.3.1.1.3 



Initial condition 



• According applet has been successfully installed and selected using ISO Interface and the applet is set into 
ACTIVATED state. 

• The UICC has sent EVT_READER_REQUESTED on HCI interface. 
6.2.3.1.1.4 Test procedure 



Test case 


ID 


HCI Command | API Description | API Expectation | HCI Response | CRR 


1 


MULTIPLE_TARGET_STATUS is received - Type A 


Send 

EVT TARGET Dl 

SGOVERED(Statu 

s = '03') 


restartReaderModeProcedure ( ) 

event = EVT_END_OPERATION 
event = EVT_READER_REQUESTED 


No exception shall 
be thrown 


EVT END OPER 
ATION 

EVT READER R 
EQUESTED 


N1, 
N2, 
N3 


2 


MULTIPLE_TARGET_STATUS is received - Type B 


Send 

EVT TARGET Dl 

SCOVERED(Statu 

s = '03') 


restartReaderModeProcedure ( ) 

event = EVT_END_OPERATION 
event = EVT_READER_REQUESTED 


No exception shall 
be thrown 


EVT END OPER 
ATION 

EVT READER R 
EQUESTED 


Ml, 

N2, 
N3 


3 


RESP_WR_RF_ERROR is received 


-Send 

EVT TARGET Dl 

SCOVERED 

(status = '00') 

-WR_RF_ERROR 


- prepareAndSendWriteXchgDataCommand ( ) 
timeout = -1 

data = '01...01' 
offset = 
len = 10 

- restartReaderModeProcedure ( ) 
event = EVT_END_OPERATION 
event = EVT READER REQUESTED 


No exception shall 
be thrown 


WR_XCHG_DATA 

EVT END OPER 
ATION 

EVT READER R 
EQUESTED 


N1, 
N2, 
N3 


4 


RESP_ANY_E_TIMEOUT is received 


-Send 

EVT TARGET Dl 

SCOVERED 

(status = '00') 

ANY_E_TIMEOUT 


- prepareAndSendWriteXchgDataCommand ( ) 
timeout = -1 

data = 'OI...O1' 
offset = 
len = 10 

- restartReaderModeProcedure ( ) 
event = EVT_END_OPERATION 
event = EVT READER REQUESTED 


No exception shall 
be thrown 


WR_XCHG_DATA 

EVT END OPER 
ATION 

EVT READER R 
EQUESTED 


N1, 
N2, 
N3 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


GRR 


5 


HCI Interface Is disabled 


1 - Precondition: 


restartReaderModeProcedure ( ) 


Shall throw 


- SW - '90 03' 


CI 




Contactless 




uicc.hci.framework. 


No 






functionality state 
is disabled in the 


event = EVT END OPERATION 
event = EVT_READER_REQUESTED 


HCIException with 
error code 


EVT READER R 
EOUESTED shall 






UICC as defined 




HCI CURRENTLY 


be sent 






in TS 1 02 223 [7] 




DISABLED 








- Send APDU to 












select the applet. 












-Send 












EVT TARGET Dl 












SCOVERED 












(status = '03') 












- Send APDU on 












ISO interface ('01') 










2 - Precondition: 


setCommunicationlnterf ace ( ) API method of 


Shall throw 


- SW - '90 03' 


CI 




Contactless 


Global Platform Amendment C [10] is used 


uicc.hci.framework. 


No 






functionality state 


to disable HCI interface 


HCIException with 


EVT READER R 






is disabled in the 


- restartReaderModeProcedure ( ) 


error code 


EOUESTED shall 






UICC as defined 




HCI CURRENTLY 


be sent 






in Global Platform 


event = EVT_END_OPERATION 


DISABLED 








Amendment C 


event = EVT_READER_REQUESTED 










Send on ISO 












interface send the 


setCommunicationlnterf ace ( ) API method of 










following 
commands: 


Global Platform Amendment C [10] is used 










to enable again HCI interface 










-Send 












EVT TARGET Dl 












SCOVERED 












(status = '03') 












- Send APDU on 












ISO interface ('01') 












- Postcondition: 












Contactless 












functionality state 












is enabled again in 












the UICC as 












defined in Global 












Platform 












Amendment C 











6.2.3.1 .2 Method prepareAndSendWriteXchgDataCommand 

Test Area Reference: Api_2_RMm_Srx 

6.2.3.1.2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendWriteXchgDataCommand {byte timeout, 

byte [] data, 

short offset, 

short len) 

throws HCIException, 

Java . lang.NullPointerException, 

j ava . lang . ArraylndexOutOf BoundsException, 

j avacard . f rameworlc . SystemException 
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6.2.3.1.2.1.1 



Normal execution 



• CRRNl: this non-blocking method builds the HCI command WR_XCHG_DATA with the data passed in the 
parameter data and sends it to the Contactless Reader Gate of the CLF. 

• CRRN2: The response data from the CLF will be transferred to the UICC with the event 
ReaderListener.EVENT_WRITE_EXCHANGE_DATA_RESPONSE. 

• CRRN3: to be able to receive and send messages over the contactless interface in reader mode the applet shall 
activate the ReaderListener.EVENT_TARGET_DISCOVERED. 

• CRRN4: an Applet has to be in the selectable state (according to the Java Card'"^ specification [11], [12] and 
[13]) to act as a contactless Applet in reader mode. 

6.2.3.1.2.1.2 Parameter errors 

• CRRPl: throw java.lang.NuUPointerException if data is null. 

• CRRP2: throw java.lang.ArraylndexOutOfBoundsException if operation would cause access of data outside 
array bounds. 

• CRRP3: throw javacard. framework. SystemException with the error code ILLEGAL_VALUE if the timeout 
value does not match with the predefined values. 



6.2.3.1.2.1.3 



Context errors 



CRRCl: throw HCIException with error code reason HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

CRRC3: throw HCIException with error code reason HCI_FRAGMENTED_MESSAGE_ONGOING if the 
Contactless Framework is still receiving a fragmented HCI Message. 



6.2.3.1.2.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 RMm Srx l.java 


1 


Api 2 RMm Srx l.java 


2 


Api 2 RMm Srx 2.java 


3-1 


Api 2 RMm Srx S.java 


3-2 


Api 2 RMm Srx 2.]ava 


4 


Api 2 RMm Srx 2.java 


5 


Api 2 RMm Srx 2.java 


6 


Api 2 RMm Srx 2.java 


7 



6.2.3.1.2.3 



Initial condition 



• According applet has been successfully installed and selected using ISO Interface and the applet is set into 
ACTIVATED state. 



TheUICC has sent EVT_READER_REQUESTED on HCI interface. 
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6.2.3.1. 2A 



Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


1 


Send Data - Type A 


-Send 


prepareAndSendWriteXchgDataCommand { ) 


No exception shall be 


- command 


N1, 




EVT TARGET Dl 


timeout = -1 


thrown 


WR XCHG DAT 


N2, 




SCOVERED 


data = ' 01...01 ' 




A 


N3, N4 




(status = '00') 


offset = 
len = 10 




Is received 






- Send ANY OK 










2 


Send Data - Type B 


-Send 


prepareAndSendWriteXchgDataCommand { ) 


No exception shall be 


- command 


N1, 




EVT TARGET Dl 


timeout = -1 


thrown 


WR XCHG DAT 


N2, 




SCOVERED 


data = ' 01...01' 




A 


N3, N4 




(status = '00') 


offset = 
len = 10 




Is received 






- Send ANY OK 










3 


HCI Interface Is disabled 


1 - Precondition: 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw 


-SW-'90 01' 


C1 




Contactless 


timeout = 14 


uicc.hci.frameworl<.HCIEx 








functionality 
stateis disabled in 


data = '01...01' 
offset = 
len = 10 


ception with error code 
HCI CURRENTLY DISA 








the UICC as 




BLED 








defined in TS 102 












223 [7] 












- Send APDU on 












ISO interface to 












select tlie applet 












-Send 












EVT TARGET Dl 












SCOVERED 












(status = '00') 












- Send APDU on 












ISO interface (INS 
= •11') 










2 - Precondition: 


setCommunicationlnterf ace { ) API method 


Shall throw 


-SW-'90 01' 


C1 




Contactless 


of Global Platform Amendment C [10] 


uicc.hci.frameworl<.HCIEx 








functionality state 


is used to disable HCI interface 


ception with error code 








is disabled in tlie 


prepareAndSendWriteXchgDataCommand { ) 


HCI_CURRENTLY_DISA 








UICC as defined 


timeout = 14 


BLED 








in Global Platform 


data = ' 01...01 ' 










Amendment C 


offset = 










Send on ISO 


len = 10 










interface send the 












following 
commands: 


setCommunicationlnterf ace { ) API method 










of Global Platform Amendment C [10] 










is used to enable again HCI interface 










- Send APDU on 












ISO interface to 












select the applet 












-Send 












EVT TARGET Dl 












SCOVERED 












(status = '00') 












- Send APDU on 












ISO interface (INS 












= •01') 












- Postcondition: 












Contactless 












functionality state 












is enabled again in 












the UICC as 












defined in Global 












Platform 












Amendment C 











£75/ 



Release 9 



78 



ETSI TS 103 115 V9.1.0 (2013-07) 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


4 


Data is null 


- Send APDU on 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw 


- SW - '90 02' 


PI 




ISO interface (INS 

= '02') 

-Send 

EVT TARGET Dl 


timeout = 14 
data = null 
offset = 
len = 10 


java.lang.NullPointerExce 
ption 








SCOVERED 












(status = '00') 












- Send APDU on 












ISO interface ('12') 










5 


ArraylndexOutOfBounds Exception 


- Send APDU on 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw java.lang. 


- SW - '90 03' 


P2 




ISO interface (INS 

= '03') 

-Send 

EVT TARGET Dl 


timeout = 14 
data = ' 01...01 ' 
offset = -1 
len = 10 


Array IndexOutOfBoundsE 
xception 








SCOVERED 












(status = 00) 












- Send APDU on 












ISO interface ('13') 










6 


ArraylndexOutOfBounds Exception 


- Send APDU on 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw java.lang. 


- SW - '90 04' 


P2 




ISO interface (INS 

= '03') 

-Send 

EVT TARGET Dl 


timeout = 14 
data = ' 01...01' 
offset = 
len = 11 


Array IndexOutOfBoundsE 
xception 








SCOVERED 












(status = '00') 












- Send APDU on 












ISO interface (INS 












= '13') 










7 


Timeout has illegal value 


-Send 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw 


- SW - '90 05' 


P3 




EVT TARGET Dl 


timeout = -2 


uicc.hci. framework. HClEx 








SCOVERED 

(status = 00) 


data = ' 01...01 ' 
offset = 
len - 10 


ception with error code 
ILLEGAL VALUE 








- Send APDU on 












ISO interface (INS 












= '01') 











6.2.3.1.3 Method prepareAndSendGetParameterCommand 

Test Area Reference: Api_2_RMm_Sgp. 

6.2.3.1.3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendGetParameterCommand {byte paramid) 

throws HCIException, 

j avacardf ramework . SystemException 



6.2.3.1.3.1.1 



Normal execution 



• CRRN 1 : This non-blocking method builds the HCI command ANY_GET_PARAMETER for the indicated 
information and sends it to the Contactless Reader Gate of the CLF. 

• CRRN2: this method should only be called when the CLF has successfully discovered a card in the field, 
i.e. after reception of the HCI event EVT_TARGET_DISCOVERED. 

• CRRN3; paramid shall be one of the PARAM_* values defined in this interface. 



£75/ 



Release 9 



79 



ETSI TS 103 115 V9.1.0 (2013-07) 



6.2.3.1.3.1.2 



Parameter errors 



CRRPl: throwjavacard.framework.SystemException - with the following reason code ILLEGAL_VALUE if 
the paramID does not match with the predefined values. 



6.2.3.1.3.1.3 



Context errors 



CRRCl: throw HCIException with error code reason HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

CRRC3: throw HCIException with error code reason HCI_FRAGMENTED_MESSAGE_ONGOING if the 
Contactless Framework is still receiving a fragmented HCI Message. 



6.2.3.1.3.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 RMm Sgp l.java 


1 


Api 2 RMm Sgp l.java 


2 


Api 2 RIVIm Sgp 2.java 


3-1 


Api 2 RIVIm Sgp S.java 


3-2 


Api 2 RMm Sgp 2.java 


4 


Api 2 RMm Sgp 2.java 


5 



6.2.3.1.3.3 



Initial condition 



According applet has been successfully installed and selected using ISO Interface and the applet is set into 
ACTIVATED state. 



The UICC has sent EVT_READER_REQUESTED on HCI interface. 



6.2.3.1.3.4 



Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


1 


Get Parameter: Type A 


1 - Send APDU on ISO 


prepareAn(iSen(iGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = '01') 


paramid = PARAM_ID_TYPE_A_READER_UID 


be thrown 


GET PARAMETE 


N2, 




-Send 






R with command 


N3 




EVT TARGET DISCO 


Response received: 
onCallback ( ) 




parameter as 






VERED (status = '00') 


event = EVENT GET PARAMETER RESPONSE 




indicated in the 






- Send APDU on ISO 






API Description 






interface (INS = '20') 






column 

- APDU-Response 

'0100' 




2 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = '02') 


paramid 


be thrown 


GET PARAMETE 


N2, 




-Send 


PARAM_ID_TYPE_A_READER_ATQA 




R with command 


N3 




EVT TARGET DISCO 


Response received: 




parameter as 






VERED (status = '00') 


onCallback () 




indicated in the 






- Send APDU on ISO 


event = EVENT GET PARAMETER RESPONSE 




API Description 






interface (INS = '20') 






column 

- APDU-Response 

'0200' 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 




3 - Send APDU on ISO 


prepareAnciSenciGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = '03') 


paramid 


be thrown 


GET_PARAMETE 


N2, 




-Send 


PARAM_ID_TYPE_A_READER_APPLICATION_DA 




R with command 


N3 




EVT TARGET DISCO 


TA 




parameter as 






VERED (status = '00') 


Response received: 




indicated in the 






- Send APDU on ISO 


onCallback () 




API Description 






interface (INS = '20') 


event = EVENT_GET_PARAMETER_RESPONSE 




column 

- APDU-Response 

'0300' 






4 - Send 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




EVT TARGET DISCO 


paramid 


be thrown. 


GET_PARAMETE 


N2, 




VERED (status = '00') 


PARAM_ID_TYPE_A_READER_SAK 




R with command 


N3 




- Send APDU on ISO 


Response received: 




parameter as 






interface (INS = '20') 


onCallback () 

event = EVENT_GET_PARAMETER_RESPONSE 




indicated in the 

API Description 

column 

- APDU-Response 

'0400' 




5 - Send 


- prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




EVT TARGET DISCO 


paramid 


be thrown 


GET_PARAMETE 


N2, 




VERED (status = '00') 


PARAM_ID_TYPE_A_READER_FWI 




R with command 


N3 




- Send APDU on ISO 


Response received: 




parameter as 






interface (INS = '20') 


onCallback () 

event = EVENT_GET_PARAMETER_RESPONSE 




indicated in the 

API Description 

column 

- APDU-Response 

'0500' 




6 - Send 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




EVT TARGET DISCO 


paramid 


be thrown 


GET_PARAMETE 


N2, 




VERED (status = '00') 


PARAM_ID_TYPE_A_READER_DATARATE_MAX 




R with command 


N3 




- Send APDU on ISO 


Response received: 




parameter as 






interface (INS = '20') 


onCallback () 

event = EVENT_GET_PARAMETER_RESPONSE 




indicated in the 

API Description 

column 

- APDU-Response 

'0600' 




2 




Get Parameter: Type 


B 








1 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = '07') 


paramid 


be thrown 


GET_PARAMETE 


N2, 




-Send 


PARAM_ID_TYPE_B_READER_PUPI 




R with command 


N3 




EVT TARGET DISCO 


Response received: 




parameter as 






VERED (status = '00') 


onCallback () 




indicated in the 






- Send APDU on ISO 


event = EVENT_GET_PARAMETER_RESPONSE 




API Description 






interface (INS = '20') 






column 

- APDU-Response 

'0700' 




2 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = '08') 


paramid 


be thrown 


GET_PARAMETE 


N2, 




-Send 


PARAM_ID_TYPE_B_READER_APPLICATION_DA 




R with command 


N3 




EVT TARGET DISCO 


TA 




parameter as 






VERED (status = '00') 


Response received: 




indicated in the 






- Send APDU on ISO 


onCallback () 




API Description 






interface (INS = '20') 


event = EVENT_GET_PARAMETER_RESPONSE 




column 

- APDU-Response 

'0800' 




3 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = '09') 


paramid 


be thrown 


GET_PARAMETE 


N2, 




-Send 


PARAM_ID_TYPE_B_READER_AFI 




R with command 


N3 




EVT TARGET DISCO 


Response received: 




parameter as 






VERED (status = '00') 


onCallback () 




indicated in the 






- Send APDU on ISO 


event = EVENT_GET_PARAMETER_RESPONSE 




API Description 






interface (INS = '20') 






column 

- APDU-Response 

'0900' 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 




4 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = 'OA') 


paramid 


be thrown 


GET_PARAMETE 


N2, 




-Send 


PARAM_ID_TYPE_B_READER_HIGHER_LAYER_R 




R with command 


N3 




EVT TARGET DISCO 


ESPONSE 




parameter as 






VERED (status = '00') 


Response received: 




indicated in the 






- Send APDU on ISO 


onCallback () 




API Description 






interface (INS = '20') 


event = EVENT_GET_PARAMETER_RESPONSE 




column 

- APDU-Response 

'OAOO' 






5 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = 'OB') 


paramid 


be thrown 


GET_PARAMETE 


N2, 




-Send 


PARAM_ID_TYPE_B_READER_HIGHER_LAYER_D 




R with command 


N3 




EVT TARGET DISCO 


ATA 




parameter as 






VERED (status = '00') 


Response received: 




indicated in the 






- Send APDU on ISO 


onCallback () 




API Description 






interface (INS = '20') 


event = EVENT GET PARAMETER RESPONSE 




column 

- APDU-Response 

'OBOO' 




3 


HCI Interface Is disabled 


1 - Precondition: 


- prepareAndSendGetParameterCommand ( ) 


Shall throw 


- SW - '90 03' 


CI 




Contactless functionality 


paramid 


uicc.hci. framework. 








state is disabled in the 


PARAM_ID_TYPE_A_READER_UID 


HCIException with 








UICC as defined in 




error code 








TS 1 02 223 [7] 




HCI CURRENTLY 








- Send APDU on ISO 




DISABLED 








interface (INS = '01') 












-Send 












EVT TARGET DISCO 












VERED (status = '00') 












- Send APDU on ISO 












interface (INS = '11') 










2 - Precondition: 


setCommunicationlnterf ace ( ) API 


Shall throw 


- SW - '90 03' 


CI 




Contactless functionality 


method of Global Platform Amendment 


uicc.hci. framework. 








state is disabled in the 
UICC as defined in 


C [10] is used to disable HCI 
interface 


HCIException with 
error code 








Global Platform 


prepareAndSendGetParameterCommand ( ) 


HCI CURRENTLY 








Amendment C Send on 


paramid 


DISABLED 








ISO interface send the 


PARAM_ID_TYPE_A_READER_UID 










following commands: 












- Send APDU on ISO 


setCommunicationlnterf ace ( ) API 










interface to select the 


method of Global Platform Amendment 










applet 


C [10] is used to enable again HCI 
interface 










-Send 












EVT TARGET DISCO 












VERED (status = '00') 












- Send APDU on ISO 












interface (INS = '11') 












- Postcondition: 












Contactless functionality 












state is enabled again in 












the UICC as defined in 












Global Platform 












Amendment C 
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Test case 


ID 


HCI Command 


API Description API Expectation HCI Response 


CRR 


4 


The Contactless Framework is receiving fragmented IHCI Message 


- Send APDU on ISO 


- prepareAndSendGetParameterCommand ( ) 


Shall throw 


- SW - '90 04' 


C3 




interface (INS = '02') 


paramid 


uicc.hci.framework. 








-Send 


PARAM_ID_TYPE_A_READER_UID 


HCIException with 








EVT TARGET DISCO 




error code 








VERED (status = '00') 




HCI FRAGMENTE 
D MESSAGE ONG 








- Send ANY OK as 




OING 








fragmented HCI 












Message (data iengtfi = 












supported buffer size + 












5 bytes, message not 












complete) 












- Send APDU on ISO 












interface (INS = '12') 










5 


The parameter has an illegal value 


- Send APDU on ISO 


- prepareAndSendGetParameterCommand ( ) 


Shall throw 


- SW-'90 05' 


PI 




interface (INS = '05') 


paramid = -1 


uicc.hci.framework. 








- Send 




HCIException with 








EVT TARGET DISCO 
VERED (status = '00') 




error code 
ILLEGAL_VALUE 








- Send APDU on ISO 












interface (INS = '15') 











6.2.3.2 



Interface ReaderListener 



6.2.3.2.1 Method onCallback 

Test Area Reference: Api_2_Rml_Ocb. 

6.2.3.2.1.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void onCallback {byte event, HCIMessage message) 



6.2.3.2.1.1.1 



Normal execution 



CRRNl: The Contactless Framework shall invoke the method ReaderListener.onCallback only with events 
which are defined in ReaderListener or HCIListener and only with ReaderMessage objects. 

CRRN2: The Applet instance shall activate the events with ReaderService.activateEvent before it will receive 
any event notification. 



6.2.3.2.1.1.2 

• None. 

6.2.3.2.1.1.3 

• None. 



Parameter errors 



Context errors 
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6.2.3.2.1.2 



Test Suite Files 



Applet Name 


Test case ID 


Api 2 Rml Ocb l.java 


1 


Api 2 Rml Ocb l.java 


2 


Api 2 Rml Ocb l.java 


3 


Api 2 Rml Ocb l.java 


4 


Api 2 Rml Ocb l.java 


5 


Api 2 Rml Ocb l.java 


6 


Api 2 Rml Ocb l.java 


7 


Api_2_Rml_0cb_1 .Java 


8 



6.2.3.2.1.3 



Initial conditions 



• According applet has been successfully installed and selected using ISO Interface and the applet is set into 
ACTIVATED state. 

• The UICC has sent EVT_READER_REQUESTED on HCI interface. 
6.2.3.2.1.4 Test procedure 



Test Case 


ID 


HCI Command API Description API Expectation 


HCI Response 


CRR 


1 


EVENT_TARGET_DISCOVERED - Type A 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


WR XCHG DAT 


N1, 




to select applet. 


activateEvent ( ) 


be thrown. 


A ('00 01 00 00') 


N2 




- select applet APDU (INS = '10') 


event = 

EVENT TARGET DISCOVERED 


onCallbackO 


is received 






-Send 




method shall notice 








EVENT TARGET DISCOVERE 




the event 








D (status = '00') 










EVENT_WRITE_EXCHANGE_DATA_RESPONSE - Type A 


2 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


Start bulk data 


N1, 




to select applet. 


activateEvent ( ) 


be thrown. 


transfer on HCI 


N2 




- select applet APDU(INS = '11') 


event = 

EVENT WRITE EXCHANGE DATA RES 


onCallbackQ 


interface. 






-Send 


PONSE 


method shall notice 








EVT TARGET DISCOVERED 




the event 








(status = '00') 












- Send ANY OK () 










HCIListener.EVENT HCI TRANSMISSION FAILED - Type A 


3 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


-No 


N1, 




to select applet. 

- select applet APDU (INS = '12') 

-Send 

EVT TARGET DISCOVERED 


activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_TRANSMI 

SSION FAILED 


be thrown. 

onCallbackQ 
method shall notice 


WR_XCHG_DAT 
A is received. 

- SW - '90 00' 


N2. 




(status = '00') 




the event 








- Send ANY_OK ('1 1 22 33 44 












00'), RF error indicator is set to 

'01' 

- Send APDU (INS = '2') on ISO 






















interface 










EVENT GET PARAMETER RESPONSE - Type A 


4 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


ANY GET PAR 


N1, 




to select applet. 




be thrown. 


AMETER is 


N2 




- select applet APDU(INS = '13') 

-Send 

EVT TARGET DISCOVERED 


activateEvent ( ) 

event = 

EVENT_GET_PARAMETER_RESPONSE 


onCallbackQ 
method shall notice 


received 






(status = '00') 




the event 








- Send ANY OK () 
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Test Case 


ID 


HCI Command API Description API Expectation 


HCI Response 


CRR 


5 


EVENT_TARGET_DISCOVERED - Type B 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


WR XCHG DAT 


N1, 




to select applet. 


activateEvent ( ) 


be thrown. 


A ('00 01 00 00') 


N2 




- select applet APDU (INS = '10') 


event = 

EVENT TARGET DISCOVERED 


onCallbackQ 


is received 






-Send 




method shall notice 








EVENT TARGET DISCOVERE 




the event 








D (status = '00') 










EVENT_WRITE_EXCHANGE_DATA_RESPONSE - Type B 


6 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


Start bulk data 


N1, 




to select applet. 


activateEvent ( ) 


be thrown. 


transfer on HCI 


N2 




- select applet APDU(INS = '11') 


event = 

EVENT WRITE EXCHANGE DATA RES 


onCallbackQ 


interface. 






-Send 


PONSE 


method shall notice 








EVT TARGET DISCOVERED 




the event 








(status = '00') 












- Send ANY OK () 










HCIListener.EVENT_HCLTRANSMISSION FAILED - Type B 


7 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


-No 


N1, 




to select applet. 

- select applet APDU (INS = '12') 

-Send 

EVT TARGET DISCOVERED 


activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_TRANSMI 

SSION FAILED 


be thrown. 

onCallbackQ 
method shall notice 


WR_XCHG_DAT 
A () is received. 

- SW - '90 00' 


N2. 




(status = '00') 




the event 








- Send ANY_OK ('1 1 22 33 44 












00'), RF error indicator is set to 

'01' 

- Send APDU (INS = '2') on ISO 






















interface 










EVENT GET PARAMETER_RESPONSE - Type B 


8 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


ANY GET PAR 


N1, 




to select applet. 




be thrown. 


AMETER is 


N2 




- select applet APDU(INS = '13') 

-Send 

EVT TARGET DISCOVERED 


activateEvent ( ) 

event = 

EVENT_GET_PARAMETER_RESPONSE 


onCallbackQ 
method shall notice 


received 






(status = '00') 




the event 








- Send ANY OK () 
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Annex A (normative): 

Class, methods and tests acronyms 

A.1 HCI framework 



Class name 


Acronyms 


HCIDevice 


Hdv 


HCISevice 


HSr 


HCIMessage 


Hme 


HCIListener 


HIn 


HCIException 


Hxp 



A.1.1 Class HCIDevice 



Method name 


Acronyms 


public static HCIService getHCIService { ) 


Gsr 


public static byte getPowerMode { ) 


Gpm 


public static byte isHCIServiceAvailable { ) 


Isa 



A.1 .2 Interface HCIService 



Method name 


Acronyms 


void register {) 


Reg 


void deregisterO 


Drg 


void activateEvent { ) 


Ace 


void deactivateEvent { ) 


Dae 


void requestCallbackNotif ication { ) 


Ren 


boolean getEventNotif icationStatus {) 


Gen 



A. 1.3 Interface HCIMessage 



Method Name 


Acronyms 


boolean isHeadingO 


Mhd 


boolean isCompleteO 


Mco 


byte getType { ) 


Mty 


byte getlnstruction { ) 


Min 


short getReceiveOf f set { ) 


Mro 


short getReceiveLength { ) 


Mrl 


byte[] getReceiveBuf fer {) 


Mrb 



A. 1.4 Interface HCIListener 



Method Name 


Acronyms 


void onCallbackO 


Ocb 
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Method Name 


Acronyms 


public static void throwItO 


Trw 



A.2 
A.2.1 



HCI Services 
Package cardemulation 



Interface Name 


Acronyms 


CardEmulationMessage 


CEm 


CardEmulationService 


CEs 



A.2.1 .1 Interface CardEmulationLlstener 



Method Name 


Acronyms 


void onCallbackO 


Ocb 



A.2. 1.2 Interface CardEmulationMessage 



Method Name 


Acronyms 


void prepareAndSendGetParameterCommand { ) 


Sgp 


void prepareAndSendSendDataEvent { ) 


Ssd 


boolean selectingMessage { ) 


Scm 



A.2. 1.3 Interface CardEmulationService 



Method Name 


Acronyms 


byte getCardRFType { ) 


Rft 



A.2. 2 Package connectivity 



Interface Name 


Acronyms 


ConnectivityMessage 


CNm 


Connect ivityService 


CNs 



A.2. 2.1 Interface ConnectivityListener 

FFS 

A.2. 2. 2 Interface ConnectivityMessage 

FFS 
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A.2.2.3 Interface ConnectivityService 



Method Name 


Acronyms 


prepareAndSendConnectivityEvent { ) 


See 


prepareAndSendTransactionEvent {byte [] aid, 

short aidOffset, short aidLen, byte [] parameters, 

short parametersOf f set , short parametersLen) 


Ste 


prepareAndSendTransactionEvent {byte [] parameters, short 
parametersOf f set , short parametersLen) 


Stt 



A.2.3 Readermode 



A.2.3.1 Interface RaederListener 



Method Name 


Acronyms 


void onCallback{) 


Ocb 



A.2.3. 2 Interface ReaderMessage 



Method Name 


Acronyms 


void prepareAndSendGetParameterCommand { ) 


Sgp 


void prepareAndSendWriteXchgDataCommand { ) 


Srx 


void restartReaderModeProcedure { ) 


Rrp 



A.2.3. 3 Interface ReaderService 

FFS 
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Annex B (normative): 
AIDs - to be reserved 

B.1 Package HCI framework 



Package name 


AID 


uicc. test. hci. framework 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 00 00 00 



B.1.1 Class HCIDevice 



Package name 


AID 


uicc.test.hci.framework. Api 1 


Hdv Gsr 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 01 00 00 


uicc. test. hci. framework. Api 1 


Hdv Gpm 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 02 00 00 


uicc.test.hci.framework. Api 1 


Hdv Isa 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 03 00 00 



Applet name 


AID 


Api 1 Hdv Gsr l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 01 01 02 


Api 1 Hdv Gsr 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 01 02 02 


Api 1 Hdv Gpm l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 02 01 02 


Api 1 Hdv Isa l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 03 01 02 


Api 1 Hdv Isa 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 03 02 02 


Api 1 Hdv Isa S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 03 03 02 



B.1 .2 Interface HCIService 



Package name 


AID 


uicc.test.hci.framework. Api 1 Hsr Reg 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 00 00 


uicc.test.hci.framework. Api 1 Hsr Drg 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 05 00 00 


uicc.test.hci.framework. Api 1 Hsr Ace 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 00 00 


uicc.test.hci.framework. Api 1 Hsr Dae 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 00 00 


uicc.test.hci.framework. Api 1 Hsr Ren 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 08 00 00 


uicc.test.hci.framework. Api_1_Hsr_Gen 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 09 00 00 



Applet name 


AID 


Api 1 Hsr Reg l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 01 02 


Api 1 Hsr Reg 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 02 02 


Api 1 Hsr Reg 3.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 03 02 


Api 1 Hsr Reg 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 04 02 


Api 1 Hsr Drg l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 05 01 02 


Api 1 Hsr Drg 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 05 02 02 


Api 1 Hsr Ace l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 01 02 


Api 1 Hsr Ace 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 02 02 


Api 1 Hsr Ace 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 04 02 


Api 1 Hsr Ace 5.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 05 02 


Api 1 Hsr Ace 6.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 06 02 


Api 1 Hsr Ace 7.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 07 02 


Api 1 Hsr Ace 8.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 08 02 


Api 1 Hsr Ace 9.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 09 02 


Api 1 Hsr Dae l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 01 02 


Api 1 Hsr Dae 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 02 02 


Api 1 Hsr Dae 3.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 03 02 


Api 1 Hsr Dae 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 04 02 


Api 1 Hsr Dae 6.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 06 02 


Api 1 Hsr Ren 7.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 08 07 02 
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Applet name 


AID 


Api 1 Hsr Gen l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 09 01 02 


Api 1 Hsr Gen 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 09 02 02 



B.1.3 Interface HC I Message 



Package name 


AID 


uicc. test. hci. framework. Api 1 Hme Mhd 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OA 00 00 


uicc.test.hci.framework. Api 1 Hme IVIco 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OB 00 00 


uicc. test. hci. framework. Api 1 Hme Mty 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OC 00 00 


uicc.test.hci.framework. Api 1 Hme IVIin 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OD 00 00 


uicc.test.hci.framework. Api 1 Hme Mro 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OE 00 00 


uicc.test.hci.framework. Api 1 Hme Mrl 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OF 00 00 


uicc.test.hci.framework. Api_1_Hme_Mrb 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 10 00 00 



Applet name 


AID 


Api 1 Hme IVIhd l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OA 01 02 


Api 1 Hme IVIco l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OB 01 02 


Api 1 Hme IVIty l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OC 01 02 


Api 1 Hme IVIty 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OC 02 02 


Api 1 Hme IVIin l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OD 01 02 


Api 1 Hme IVIin 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OD 02 02 


Api 1 Hme Mrl l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OF 01 02 


Api 1 Hme Mrb l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 10 01 02 



B.1.4 Interface HCIListener 



Package name 


AID 


uicc.test.hci.framework. Api_1_Hln_0cb 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 00 00 



Applet name 


AID 


Api 1 HIn Ocb l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 01 02 


Api 1 HIn Ocb 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 02 02 


Api 1 HIn Ocb S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 03 02 


Api 1 HIn Ocb 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 04 02 


Api 1 HIn Ocb 5.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 05 02 


Api_1_Hln_0cb_6.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 06 02 



B.1.5 Class HCIException 



Package name 


AID 


uicc.test.hci.framework. Api 1 Hxp Trw 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 12 00 00 




Applet name 


AID 


Api 1 Hxp Trw l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 12 01 02 
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B.2 HCI Services 



B.2.1 Package cardemulation 



Package name 


AID 


uicc.test.hci.services.cardemulation 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 00 00 00 



B.2.1 .1 Interface CardEmulationListener 



Package name 


AID 


uicc.test.hci.services.cardemulation.Api_2_CEI_Ocb 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 00 00 



Applet name 


AID 


Api 2 CEI Ocb Ljava 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 01 02 


Api 2 CEI Ocb 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 02 02 


Api 2 CEI Ocb S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 03 02 


Api 2 CEI Ocb 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 04 02 


Api 2 CEI Ocb 5.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 05 02 


Api 2 CEI Ocb 6.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 06 02 


Api 2 CEI Ocb 7.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 07 02 


Api_2_CEI_Ocb_8.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 08 02 



B.2. 1.2 Interface CardEmulationMessage 



Package name 


AID 


uicc.test.lici.services.cardemulation.Api 2 CEm Sgp 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 00 00 


uicc.test.lici.services.cardemulation.Api 2 CEm Ssd 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 00 00 


uicc.test.hci.services.cardemulation.Api_2_CEm_Scm 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 03 00 00 



Applet name 


AID 


Api 2 CEm Sgp l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 01 02 


Api 2 CEm Sgp 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 02 02 


Api 2 CEm Sgp 3.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 03 02 


Api 2 CEm Sgp 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 04 02 


Api 2 CEm Sgp 5.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 05 02 


Api 2 CEm Sgp 6.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 06 02 


Api 2 CEm Sgp 7.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 07 02 


Api 2 CEm Sgp S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 08 02 


Api 2 CEm Sgp 9.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 09 02 


Api 2 CEm Sgp lO.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OA 02 


Api 2 CEm Sgp 1 l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OB 02 


Api 2 CEm Sgp 12.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OC 02 


Api 2 CEm Sgp 13.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OD 02 


Api 2 CEm Sgp 14.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OE 02 


Api 2 CEm Sgp 15.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OF 02 


Api 2 CEm Ssd l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 01 02 


Api 2 CEm Ssd 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 02 02 


Api 2 CEm Ssd 3.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 03 02 


Api 2 CEm Ssd 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 04 02 


Api 2 CEm Scm l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 03 01 02 
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B.2.1.3 Interface CardEmulationService 



Package name 


AID 


uicc.test.hci.services.cardemulation.Api 2 CEs RFt 


AO 00 GO GO G9 GG 05 FF FF FF FF 89 25 04 GO GG 



Applet name 


AID 


Api 2 CEs RFt Ljava 


AO GG OG 00 09 00 05 FF FF FF FF 89 25 G4 01 02 



B.2.2 Package connectivity 



Package name 


AID 


uicc.test.hci.services.connectivity 


AO 00 00 00 09 GG 05 FF FF FF FF 89 26 00 00 00 



B.2.2. 1 Interface ConnectivityListener 

FFS 

B.2.2. 2 Interface ConnectivitylVlessage 

FFS 

B.2.2. 3 Interface ConnectivityService 



Package name 


AID 


uicc.test.hci.services.connectivity.Api 2 CNs See 


AG 00 00 00 09 00 05 FF FF FF FF 89 28 01 00 00 


uicc.test.hci.services.connectivity.Api 2 CNs Ste 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 02 00 00 


uicc.test.hci.services.connectivity.Api_2_CNs_Stt 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 03 00 00 



Applet name 


AID 


Api 2 CNs See l.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G1 01 02 


Api 2 CNs See 2.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G1 02 02 


Api 2 CNs See S.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G1 OS 02 


Api 2 CNs See 4.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G1 04 02 


Api 2 CNs See 5.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G1 05 02 


Api 2 CNs See 6.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G1 06 02 


Api 2 CNs Ste l.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G2 01 02 


Api 2 CNs Ste 2.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G2 02 02 


Api 2 CNs Ste S.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G2 OS 02 


Api 2 CNs Ste 4.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G2 04 02 


Api 2 CNs Ste 5.java 


AO GG OG 00 09 00 05 FF FF FF FF 89 26 G2 05 02 


Api 2 CNs Stt l.java 


AO 00 OG 00 09 00 G5 FF FF FF FF 89 26 GS 01 02 


Api 2 CNs Stt 2.java 


AO 00 OG 00 09 00 G5 FF FF FF FF 89 26 GS 02 02 


Api 2 CNs Stt S.java 


AO 00 OG 00 09 00 G5 FF FF FF FF 89 26 GS OS 02 


Api 2 CNs Stt 4.java 


AO 00 OG 00 09 00 G5 FF FF FF FF 89 26 GS 04 02 



B.2.3 Package readermode 



Package name 


AID 


uiec.test.hci.services. reader 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 00 00 00 
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B.2.3.1 Interface ReaderMessage 



Package name 


AID 


uicc. test. hci. services. reader. Api 2 RMm Rrp 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 01 00 00 


uicc.test.hci.services.reader.Api 2 RMm Srx 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 02 00 00 


uicc.test.hci.services.reader.Api 2 RMm Sgp 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 03 00 00 



Applet name 


AID 


Api 2 RMm Rrp l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 01 01 02 


Api 2 RMm Rrp 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 01 02 02 


Api 2 RMm Rrp S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 01 03 02 


Api 2 RMm Srx l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 02 01 02 


Api 2 RMm Srx 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 02 02 02 


Api 2 RMm Srx S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 02 03 02 


Api 2 RMm Sgp l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 03 01 02 


Api 2 RMm Sgp 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 03 02 02 


Api 2 RMm Sgp S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 03 03 02 



B.2.3.2 Interface ReaderListener 



Package name 


AID 


uicc.test.hci.services.reader.Api_2_RMI_0cb 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 04 00 00 



Applet name 


AID 


Api 2 Rml Ocb l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 04 01 02 







B.2.3.3 Interface ReaderService 

FFS 
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Annex C (normative): 
Requirements 

C.1 Non-occurrence and out-of-scope requirements 
C.1.1 Package uicc.hci 



Requirement 


Reference 


A mechanism to launch an application on the terminal host that is related to the Applet running in the 


Api_2_CNs_Ste 


UICC 


Api 2 CNs Stt 


The Contactless Framework shall add the AID of the calling Applet instance to the HCI event passed 


Api 2 CNs Stt 


to the CLF 




A mechanism that allows a UICC to start a proactive session as defined in TS 102 223 [7] 


Api 2 CNs See 


Content of the buffer outside of the area which is used for the HCI message part is undefined 


Api 1 Hme Mrb 


This method throw HCIException with error code reason HCI RESOURCES NOT AVAILABLE if 


Api 2 RIVIm Srx 


the contactless framework does not have enough resources to process the command 


Api 2 RIVIm Sgp 




Api 2 CNs See 




Api 2 CEm Ssd 




Api 2 CNs Ste 




Api 2 CNs Stt 



C. 1 .2 TS 1 02 705 prose part 



Requirement 


Reference 


To release the CLF control at the end of a transaction an Applet shall deactivate the 
ReaderListener. EVENT TARGET DISCOVERED 


4.3 


The Contactless Framework shall bind the services defined in the uicc.hci.services.cardemulation package 
to the underlying HCI resources (e.g. gates and pipes) defined by the HCI protocol as specified in [3] 


4.2 





C.2 FFS requirements 
C.2.1 Package uicc.hci 



Requirement 


Reference 


The application may use the whole receive buffer for its internal purposes. If the buffer is used for 
manipulation of sensitive data it shall be cleared by the Applet before returning to the contactless 
framework 


Api_1_Hme_IVlrb 


Throw HCIException with error code reason HCI_FRAGMENTED_MESSAGE_ONGOING if the 
Contactless Framework is still receiving a fragmented HCI Message 


Api_2_RIVIm_Srx 


Throw java.lang.ArraylndexOutOfBoundsException if operation would cause access of data outside 
array bounds 


Api_2_RIVIm_Srx 


Throws HCIException with the reason code HCI_CURRENTLY_DISABLED if the HCI interface was 
disabled 


Api 2 CEm Sgp 
Api 2 CEm Ssd 


Throw HCIException with error code reason HCI_INVALID_LENGTH if the parameter length or the 
Al D is not compliant to TS 1 02 622 [3] 


Api 2 CNs Ste 
Api 2 CNs Stt 


In the case of a fragmented incoming message this method shall return the HCI message instruction 
coded in the first part of the HCI message 


Api_1_Hme_Min 


If the message is not complete then the returned value is the actual HCI message fragment length 


Api 1 Hme Mrl 


HCIException with reason code HCI_CONDITIONS_NOT_SATISFIED if one or more conditions to 
activate the event are not satisfied 


Api_1_Hsr_Ace 


All other HCI messages shall be delivered to the Applet instance in the same order as they were 
received by the Contactless Framework 


Api_1_Hln_0cb 
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C.2.2 TS 1 02 705 prose part 



Requirement 


Reference 


When the contactless interface is disabled (cf. "state of contactless functionality" in TS 102 223 [7] and 
setCommunicationlnterfaceQ API method of "GlobalPlatform Amendment C" [10]), the Contactless 
Framework shall throw an HCIException with reason code HCI CURRENTLY DISABLED 


4.1 


The Contactless Framework shall request the reader mode control on the CLF by sending the HCI events 
EVT_READER_REQUESTED and EVT_END_OPERATION according to the state of the reader mode 
Applet 


4.3 


The Contactless Framework shall resend the EVT_READER_REQUESTED to the CLF if another Applet 
instance exists with the ReaderListener.EVENT TARGET DISCOVERED event activated 


4.3 


The EVT_READER_REQUESTED shall be sent by the Contactless Framework if an Applet instance 
activates the event ReaderListener.EVENT_TARGET_DISCOVERED and no other Applet instance has the 
event activated, i.e. it shall not be sent if the Contactless Framework has earlier sent an 
EVT READER REQUESTED due to the request from another Applet instance, which was not yet ended 
by an EVT END OPERATION 


4.3 


The Contactless Framework shall ensure that the ReaderListener.EVENT_TARGET_DISCOVERED is 
deactivated for all Applets when access to the interface is disabled on the UICC level 


4.3 


To be able to receive and send messages over the contactless interface in reader mode the applet shall 
activate the ReaderListener.EVENT TARGET DISCOVERED 


4.3 


When an Applet lifecycle state changes from ACTIVATED to DEACTIVATED the Contactless Framework 
shall enforce that the ReaderListener.EVENT TARGET DISCOVERED is deactivated 


4.3 


The HCI event EVT_END_OPERATION shall be sent to the CLF when an Applet instance or the 
Contactless Framework deactivates the event ReaderListener.EVENT TARGET DISCOVERED 


4.3 


The Contactless Framework shall inform the Applet instance which has activated the 
ReaderListener.EVENT_TARGET_DISCOVERED when a target is discovered on one of the RF 
technologies the Applet instance is registered to with its installation parameters as specified in TS 102 226 
[9] 


4.3 


Reader mode Applets shall follow the extended lifecycle model that is defined in "GlobalPlatform 
Amendment C" [10] for contactless Applets in card emulation mode (i.e. following Application Availability 
States and the related transition rules) 


4.3 


Per RF technology there shall be only one reader mode Applet in the state ACTIVATED (according to 
"GlobalPlatform Amendment C" [10]) at any time 


4.3 


When the state of a reader mode Applet changes to lifecycle ACTIVATED (according to "GlobalPlatform 
Amendment C" [10]) the Contactless Framework shall ensure that the HCI gates and pipes are setup for 
the RF technologies that are supported by the reader mode Applet 


4.3 
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Annex D (normative): 

Test Specification for Java Card™ Platform HCI API for the 

UICC 

The source files for the HCI API for the UICC Application Programming Interface for Java CardT"^ for contactless 
Applets are contained in Annex_D_TestAppletsSourceCode.zip, which accompanies the present document. 
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Annex E (normative): 

uicc.contactless.test.util package and contactless interfaces 

The use of Java as a test scripting language is optional. However, if Java is used as the test scripting language, then the 
test descriptions shall be implemented according to annex E. 

The content of this annex is TBD. 
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Annex F (normative): 
Test Area files 



The use of Java as a test scripting language is optional. However, if Java is used as the test scripting language, then the 
test descriptions shall be implemented according to annex F. 

The content of this annex is TBD. 
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Annex G (informative): 

Core specification version information 

Unless otherwise specified, the versions of TS 102 705 [1] from which conformance requirements have been extracted 
are as follows. 



Release 



Latest version from which conformance requirements 
have been extracted 

V9.3.0 
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Annex H (informative): 
Change history 



The table below indicates all changes that have been incorporated into the present document since it was placed under 
change control. 



Change history 


Date 


Meeting 


Plenary Doc 


CR 


Rev 


Cat 


Subject/Comment 


Old 


New 






SCP(1 3)000037 








Creation of the specification 




9.0.0 


2013-02 


SCP#58 


SCP(1 3)000038 


001 


- 


F 


Added definition of test case IDs 


9.0.0 


9.1.0 


2013-02 


SCP#58 


SCP(1 3)000039 


002 


- 


F 


Clarification of initial conditions activity performed by UICC 


9.0.0 


9.1.0 


2013-02 


SCP#58 


SCP(1 3)000040 


003 


- 


F 


Test case 6.1.5.1 : corrected definition of unrecognised 
Envelope 


9.0.0 


9.1.0 


2013-02 


SCP#58 


SCP(1 3)000041 


004 


- 


F 


Correction of expected HCI event for TC 6.2.2.1 .2.4 and 
6.2.2.1.3.4 ID2-1 and ID2-2 


9.0.0 


9.1.0 


2013-02 


SCP#58 


SCP(1 3)000042 


005 


- 


F 


Clarification of prepareAndSendGetParameterCommand 
test cases 


9.0.0 


9.1.0 


2013-02 


SCP#58 


SCP(1 3)000043 


006 


- 


F 


Correction of test suite files 


9.0.0 


9.1.0 


2013-02 


SCP#58 


SCP(1 3)000044 


007 


- 


F 


Correction of wrong Events deactivation 


9.0.0 


9.1.0 


2013-02 


SCP#58 


SCP(1 3)000046 


008 


- 


F 


Clarification of initial conditions related to power mode 


9.0.0 


9.1.0 


2013-02 


SCP#58 


SCP(13)000085r1 


010 


- 


F 


Modification and addition of test applets to test HCI is 
disabled condition 


9.0.0 


9.1.0 


2013-04 


SCP#59 


SCP(1 3)000086 


Oil 


1 


F 


Addition of references to GlobalPlatform APIs. 


9.0.0 


9.1.0 


2013-04 


SCP#59 


SCP(13)000087r1 


012 


- 


F 


Clarification of EVT READER REQUESTED transmission 


9.0.0 


9.1.0 


2013-04 


SCP#59 


SCP(1 3)000088 


013 


1 


F 


Correction of applet selection InTC 6.2.1.1.1 IDS 


9.0.0 


9.1.0 


2013-04 


SCP#59 


SCP(1 3)000089 


014 


- 


F 


Correction of API expected received data in TC 6.1 .3.7 


9.0.0 


9.1.0 


2013-04 


SCP#59 


SCP(1 3)000090 


015 


- 


F 


Correction of applicability for test cases 6.1.1.1 (ID3-2) 
6.1.1.2 and 6.1.2.3 (ID5) 


9.0.0 


9.1.0 


2013-04 


SCP#59 


SCP(1 3)000091 


016 


- 


F 


Modification of test procedure 6.1.1.3.4 ID3-1 and 
6.2.2.1.1.4 


9.0.0 


9.1.0 


2013-04 


SCP#59 


SCP(1 3)000092 


017 


- 


F 


Addition of Annexes E and F contents into TS 103 1 15 


9.0.0 


9.1.0 


2013-04 


SCP#59 


SCP(1 3)000093 


018 


- 


F 


Corrections to avoid failed deletions of test applets 


9.0.0 


9.1.0 


2013-04 


SCP#59 


SCP(1 3)000037 


019 


- 


F 


Corrections on Reader Mode applets 


9.0.0 


9.1.0 



£75/ 



Release 9 



100 



ETSI TS 103 115 V9.1.0 (2013-07) 



History 



Document history 


V9.0.0 


April 2013 


Publication 


V9.1.0 


July 2013 


Publication 





















£75/ 



